README.md

outline-ss-server

Linux

$ docker run --rm -it -v $PWD:/tmp golang:1.23
>>> version=1.9.2
>>> go install github.com/Jigsaw-Code/outline-ss-server/cmd/outline-ss-server@v$version
>>> cd /go/pkg/mod/github.com/\!jigsaw-\!code/outline-ss-server@v$version/cmd/outline-ss-server
>>> sed -i '90s@^@\tslog.LogAttrs(nil, slog.LevelInfo, "TCP: Found client.", slog.String("ID", entry.ID), slog.String("IP", clientIP.String()))@' ../../service/tcp.go
>>> CGO_ENABLED=0 go build -ldflags="-X 'main.version=$version-dev'" -o outline-ss-server
>>> strip outline-ss-server
>>> ./outline-ss-server -version
1.9.2-dev
>>> mv outline-ss-server /tmp
>>> exit

$ ./outline-ss-server -version
1.9.2-dev

MacOS

# setup
sudo chown root:wheel /Library/LaunchDaemons/outline-ss-server.plist

# start
sudo launchctl bootstrap system /Library/LaunchDaemons/outline-ss-server.plist

# restart
sudo launchctl kickstart -kp system/outline-ss-server

# stop
sudo launchctl bootout system/outline-ss-server

outline-ss-server.plist

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
    <dict>
        <key>Label</key>
        <string>outline-ss-server</string>
        <key>KeepAlive</key>
        <true/>
        <key>ProgramArguments</key>
        <array>
            <string>/usr/local/bin/outline-ss-server</string>
            <string>-config=config.yml</string>
            <string>-ip_asn_db=ip-asn.mmdb</string>
            <string>-ip_country_db=ip-country.mmdb</string>
            <string>-metrics=127.0.0.1:9092</string>
            <string>-replay_history=10000</string>
        </array>
        <key>StandardErrorPath</key>
        <string>/usr/local/var/log/outline-ss-server.log</string>
        <key>StandardOutPath</key>
        <string>/dev/null</string>
        <key>RunAtLoad</key>
        <true/>
        <key>WorkingDirectory</key>
        <string>/usr/local/etc/outline-ss-server</string>
        <key>UserName</key>
        <string>nobody</string>
    </dict>
</plist>