Linux

Hỗ trợ: kernel 4.4+, các distro dùng glibc. Đã kiểm tra trên Ubuntu 22.04+, Debian 12, Fedora 39+, Alpine 3.19+. Kiến trúc: amd64, arm64.

Cài đặt

Cài đặt nhanh

1. Mở một shell.

2. Chạy trình cài đặt:

   curl -sSL https://proxy.sotatek.works/releases/download/latest/install.sh | bash

   Script tải xuống binary phù hợp, xác minh checksum SHA256, đặt binary tại /usr/local/bin/sotatek-proxy (hoặc ~/.local/bin/sotatek-proxy nếu /usr/local/bin không có quyền ghi), tạo config mặc định tại ~/.config/sotatek-proxy/, và đăng ký một systemd --user unit tự khởi động theo phiên.

3. Xác minh daemon đang chạy:

   sotatek-proxy status
   curl http://127.0.0.1:3817/_proxy/healthz

Build từ source

Yêu cầu trước

• Go 1.23+ — go.dev/dl - Git — có sẵn qua package manager của distro (apt install git, dnf install git, v.v.) - make — apt install make / dnf install make

1. Clone repository:

   git clone https://github.com/sotatek-dev/sotatek-proxy.git
   cd sotatek-proxy

2. Build và cài đặt:

   bash scripts/install-from-source.sh

   Script phát hiện kiến trúc của bạn (amd64 hoặc arm64), chạy make build-linux-amd64 / make build-linux-arm64, sao chép binary tới /usr/local/bin/sotatek-proxy (hoặc ~/.local/bin/sotatek-proxy nếu /usr/local/bin không có quyền ghi), tạo config mặc định tại ~/.config/sotatek-proxy/, và đăng ký một systemd --user unit.

   Các cờ tùy chọn:

   Cờ	Mô tả
   --no-service	Chỉ binary — bỏ qua đăng ký systemd unit
   --prefix DIR	Ghi đè thư mục cài đặt

3. Xác minh daemon đang chạy:

   sotatek-proxy status
   curl http://127.0.0.1:3817/_proxy/healthz

Mẹo

Để build mà không cài đặt, chạy make build từ thư mục gốc của repo. Binary được đặt tại ./dist/sotatek-proxy.

Tự khởi động khi boot

Mặc định, các dịch vụ systemd --user chỉ khởi động khi bạn đăng nhập. Để khởi động khi boot (ví dụ: server headless), hãy bật user linger:

loginctl enable-linger $USER

Vị trí các file

Thành phần	Đường dẫn
Binary	/usr/local/bin/sotatek-proxy (hoặc ~/.local/bin/sotatek-proxy)
Config	~/.config/sotatek-proxy/config.yaml (tuân theo $XDG_CONFIG_HOME)
Logs	~/.local/state/sotatek-proxy/sotatek-proxy.log
Unit	~/.config/systemd/user/sotatek-proxy.service

Lệnh quản lý dịch vụ

sotatek-proxy status      # running / stopped
sotatek-proxy start       # start now
sotatek-proxy stop        # stop now
sotatek-proxy logs        # tail last 100 lines
sotatek-proxy uninstall   # remove systemd unit

Bạn cũng có thể dùng systemd trực tiếp:

systemctl --user status sotatek-proxy
journalctl --user -u sotatek-proxy -f

Xử lý sự cố

command not found

Nếu sotatek-proxy status báo command not found, binary đã được cài vào ~/.local/bin (do /usr/local/bin không ghi được) và thư mục đó chưa nằm trong PATH.

Thêm vào file rc của shell đúng, rồi nạp lại:

case "$(basename "${SHELL:-bash}")" in
  zsh) RC="$HOME/.zshrc" ;;
  *)   RC="$HOME/.bashrc" ;;
esac
LINE='export PATH="$HOME/.local/bin:$PATH"'
grep -qxF "$LINE" "$RC" 2>/dev/null || echo "$LINE" >> "$RC"
source "$RC"

Hoặc sửa nhanh cho phiên shell hiện tại (không cần mở phiên mới):

export PATH="$HOME/.local/bin:$PATH"
sotatek-proxy status

Cổng đang được sử dụng

ss -tlnp 'sport = 3817'
sotatek-proxy stop && sotatek-proxy start

Hoặc đặt port: 3818 trong config.yaml và khởi động lại.

Dịch vụ không khởi động được

sotatek-proxy logs
systemctl --user status sotatek-proxy
journalctl --user -u sotatek-proxy --since "10 min ago"
sotatek-proxy daemon      # foreground for debugging

Dịch vụ dừng khi đăng xuất

Bật linger:

loginctl enable-linger $USER
loginctl show-user $USER | grep Linger

Gỡ cài đặt

sotatek-proxy uninstall
rm /usr/local/bin/sotatek-proxy   # or ~/.local/bin/sotatek-proxy
rm -rf ~/.config/sotatek-proxy
rm -rf ~/.local/state/sotatek-proxy