Windows

Hỗ trợ: Windows 10 1909+, Windows 11, Windows Server 2019+. Kiến trúc: amd64 (x64). ARM64 chưa được hỗ trợ.

Yêu cầu quyền Administrator

Windows cài đặt proxy như một Windows Service cho toàn máy chạy dưới LocalSystem. Trình cài đặt phải được chạy từ PowerShell với quyền Administrator để đăng ký service và ghi vào Program Files.

Cài đặt

Cài đặt nhanh

1. Mở PowerShell với Run as Administrator.

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

   irm https://proxy.sotatek.works/releases/download/latest/install.ps1 | iex

   Script tải xuống binary phù hợp, xác minh checksum SHA256, đặt binary tại %ProgramFiles%\SotatekProxy\bin\sotatek-proxy.exe, tạo config mặc định tại %ProgramData%\SotatekProxy\config.yaml, đăng ký Windows Service SotatekProxy, và khởi động nó.

3. Mở một terminal mới để PATH được cập nhật có hiệu lực, rồi xác minh:

   sotatek-proxy status
   Invoke-WebRequest http://127.0.0.1:3817/_proxy/healthz

Build từ source

Yêu cầu trước

• Go 1.23+ — go.dev/dl - Git for Windows — git-scm.com (cũng cung cấp Git Bash và make) - make (tùy chọn) — qua Chocolatey (choco install make) hoặc đi kèm với Git for Windows

Chạy từ PowerShell với quyền Administrator để đăng ký service.

1. Clone repository:

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

2. Build binary:

   go build -o dist\sotatek-proxy.exe .\cmd\sotatek-proxy\

   Hoặc, nếu bạn đã cài make (ví dụ qua Chocolatey hoặc Git for Windows):

   dist\sotatek-proxy-windows-amd64.exe

   make build-windows-amd64

3. Cài đặt binary và đăng ký service (Admin PowerShell):

   # Create install directory
   New-Item -ItemType Directory -Force "$env:ProgramFiles\SotatekProxy\bin"
   
   # Copy binary
   Copy-Item ".\dist\sotatek-proxy.exe" "$env:ProgramFiles\SotatekProxy\bin\sotatek-proxy.exe"
   
   # Add to PATH for current session
   $env:PATH += ";$env:ProgramFiles\SotatekProxy\bin"
   
   # Register and start the Windows service
   sotatek-proxy install

4. Mở một terminal mới để PATH được cập nhật có hiệu lực, rồi xác minh:

   sotatek-proxy status
   Invoke-WebRequest http://127.0.0.1:3817/_proxy/healthz

Ghi chú

Thêm %ProgramFiles%\SotatekProxy\bin vào PATH của máy một cách vĩnh viễn qua System Properties → Environment Variables để binary có thể dùng trong tất cả các terminal trong tương lai.

Vị trí các file

Thành phần	Đường dẫn
Binary	%ProgramFiles%\SotatekProxy\bin\sotatek-proxy.exe
Config	%ProgramData%\SotatekProxy\config.yaml
Logs	%ProgramData%\SotatekProxy\logs\sotatek-proxy.log
Service	SotatekProxy (LocalSystem, tự khởi động khi boot)

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 service (admin)

Bạn cũng có thể dùng Windows Service Controller:

Get-Service SotatekProxy
Start-Service SotatekProxy
Stop-Service SotatekProxy

Cảnh báo Defender SmartScreen

Cho đến khi ký Authenticode được bật, Windows Defender SmartScreen có thể cảnh báo ở lần chạy đầu tiên. Nhấp More info → Run anyway, hoặc đưa thư mục cài đặt vào danh sách trắng với quyền administrator:

Add-MpPreference -ExclusionPath "$env:ProgramFiles\SotatekProxy\bin"

Xử lý sự cố

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

netstat -ano | findstr :3817
Stop-Service SotatekProxy ; Start-Service SotatekProxy

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

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

sotatek-proxy logs
Get-EventLog -LogName System -Source 'Service Control Manager' -Newest 20 |
    Where-Object Message -match 'SotatekProxy'
sotatek-proxy daemon         # foreground for debugging (admin)

`sotatek-proxy` không tìm thấy trong PATH

Trình cài đặt đã thêm %ProgramFiles%\SotatekProxy\bin vào machine PATH. Mở một terminal mới để áp dụng thay đổi. Nếu vẫn không tìm thấy, đăng xuất và đăng nhập lại, hoặc gọi binary bằng đường dẫn tuyệt đối:

& "$env:ProgramFiles\SotatekProxy\bin\sotatek-proxy.exe" status

Gỡ cài đặt

Từ Admin PowerShell:

sotatek-proxy uninstall
Remove-Item -Recurse -Force "$env:ProgramFiles\SotatekProxy"
Remove-Item -Recurse -Force "$env:ProgramData\SotatekProxy"

Sau đó xóa %ProgramFiles%\SotatekProxy\bin khỏi PATH của máy (System Properties → Environment Variables).