Windows

지원 환경: Windows 10 1909 이상, Windows 11, Windows Server 2019 이상. 아키텍처: amd64 (x64). ARM64는 아직 지원되지 않습니다.

설치

빠른 설치
소스에서 빌드

PowerShell을 관리자 권한으로 실행합니다.
설치 스크립트를 실행합니다:
Terminal window
```
irm https://proxy.sotatek.works/releases/download/latest/install.ps1 | iex
```
스크립트는 해당 아키텍처에 맞는 바이너리를 다운로드하고 SHA256 체크섬을 검증한 후 %ProgramFiles%\SotatekProxy\bin\sotatek-proxy.exe에 배치합니다. %ProgramData%\SotatekProxy\config.yaml에 기본 설정 파일을 생성하고, SotatekProxy Windows 서비스를 등록한 후 시작합니다.
새 터미널을 열어 업데이트된 PATH가 적용되도록 한 다음 확인합니다:
Terminal window
```
sotatek-proxy status
Invoke-WebRequest http://127.0.0.1:3817/_proxy/healthz
```

서비스를 등록하려면 관리자 권한의 PowerShell에서 실행하세요.

저장소를 클론합니다:

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

바이너리를 빌드합니다:
Terminal window
```
go build -o dist\sotatek-proxy.exe .\cmd\sotatek-proxy\
```
또는 make가 설치되어 있는 경우 (Chocolatey 또는 Git for Windows):
dist\sotatek-proxy-windows-amd64.exe
```
make build-windows-amd64
```

바이너리를 설치하고 서비스를 등록합니다 (관리자 PowerShell):

# 설치 디렉토리 생성
New-Item -ItemType Directory -Force "$env:ProgramFiles\SotatekProxy\bin"

# 바이너리 복사
Copy-Item ".\dist\sotatek-proxy.exe" "$env:ProgramFiles\SotatekProxy\bin\sotatek-proxy.exe"

# 현재 세션의 PATH에 추가
$env:PATH += ";$env:ProgramFiles\SotatekProxy\bin"

# Windows 서비스 등록 및 시작
sotatek-proxy install

새 터미널을 열어 업데이트된 PATH가 적용되도록 한 다음 확인합니다:
Terminal window
```
sotatek-proxy status
Invoke-WebRequest http://127.0.0.1:3817/_proxy/healthz
```

파일 위치

항목	경로
바이너리	`%ProgramFiles%\SotatekProxy\bin\sotatek-proxy.exe`
설정	`%ProgramData%\SotatekProxy\config.yaml`
로그	`%ProgramData%\SotatekProxy\logs\sotatek-proxy.log`
서비스	`SotatekProxy` (LocalSystem, 부팅 시 자동 시작)

서비스 명령어

sotatek-proxy status        # 실행 중 / 정지됨
sotatek-proxy start         # 지금 시작
sotatek-proxy stop          # 지금 정지
sotatek-proxy logs          # 마지막 100줄 출력
sotatek-proxy uninstall     # 서비스 제거 (관리자)

Windows 서비스 컨트롤러를 직접 사용할 수도 있습니다:

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

Defender SmartScreen 경고

Authenticode 서명이 활성화될 때까지 Windows Defender SmartScreen이 첫 실행 시 경고를 표시할 수 있습니다. 추가 정보 → 실행을 클릭하거나, 관리자 권한으로 설치 디렉토리를 허용 목록에 추가하세요:

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

문제 해결

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

또는 %ProgramData%\SotatekProxy\config.yaml에서 port: 3818로 설정하고 서비스를 재시작하세요.

sotatek-proxy logs
Get-EventLog -LogName System -Source 'Service Control Manager' -Newest 20 |
    Where-Object Message -match 'SotatekProxy'
sotatek-proxy daemon         # 디버깅을 위한 포그라운드 실행 (관리자)

설치 프로그램이 %ProgramFiles%\SotatekProxy\bin을 시스템 PATH에 추가했습니다. 새 터미널을 열어 변경 사항이 적용되도록 하세요. 여전히 인식되지 않으면 로그아웃 후 다시 로그인하거나, 절대 경로로 바이너리를 직접 호출하세요:

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

제거

관리자 PowerShell에서 실행합니다:

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

그런 다음 시스템 PATH에서 %ProgramFiles%\SotatekProxy\bin을 제거합니다 (시스템 속성 → 환경 변수).