快速開始

想要完整可照做的流程？

本頁是精簡啟動參考。如果要從 release、第一個遠端節點、完整 DNS/rules 一路做到 curl 驗證，請直接閱讀第一個代理設定實戰。

系統需求

Go 1.20 或更新版本（從原始碼建置時）。
一般 HTTP/SOCKS 使用不需要 root。
TUN、TProxy、Redir、iptables 或低連接埠可能需要 root、capabilities 或平台權限。
with_gvisor 是正式發行的標準 build tag。

取得 Aster Core

請先到下載依作業系統與 CPU 架構選檔。目前只有滾動預發行 Prerelease-main，官方編號 v* 尚未發布。舊款 x86-64 優先 amd64-v1。

Unix-like 的 binary 是 .gz，檔名為 aster-core-<os>-<arch>-alpha-main-<sha7>.gz。把 binary asset 與同一個 release 的 checksums.txt 放在同一個目錄，先核對壓縮檔，再解壓並賦予執行權限：

sha256sum --check --ignore-missing checksums.txt
gzip -dc ./aster-core-OS-ARCH-alpha-main-SHA7.gz > ./aster-core
chmod +x aster-core
./aster-core -v

checksums.txt 是整個 release 的清單；只下載單一 asset 時，--ignore-missing 會略過其他尚未下載的檔案，但仍會驗證目前目錄中存在的目標檔。

Windows asset 是 .zip；解壓後執行 aster-core-<os>-<arch>.exe -v。Asset 後綴以 release 內的 version.txt 為準，不要自行改成未在該 release 頁存在的 tag。

從原始碼建置

git clone https://github.com/Miku0139oao/aster-core.git
cd aster-core
go mod download
CGO_ENABLED=0 go build -tags with_gvisor -trimpath -o aster-core .
./aster-core -v

PowerShell 可先設定：

powershell

$env:CGO_ENABLED = "0"
go build -tags with_gvisor -trimpath -o aster-core.exe .

建立最小設定

建立 config/config.yaml：

yaml

mixed-port: 7890
allow-lan: false
mode: rule
log-level: info

external-controller: 127.0.0.1:9090
secret: "replace-this-controller-secret"

dns:
  enable: true
  enhanced-mode: fake-ip
  nameserver:
    - system

rules:
  - MATCH,DIRECT

這份設定的用途是確認核心可以啟動：

127.0.0.1:7890：HTTP 與 SOCKS mixed proxy。
127.0.0.1:9090：Controller API。
MATCH,DIRECT：所有流量直連，不會使用遠端代理。

WARNING

這不是正式代理 profile。加入遠端 proxy、proxy group 與分流規則後，才會真正透過代理送出流量。

驗證設定

./aster-core -d ./config -f ./config/config.yaml -t

成功時會顯示：

text

configuration file ... test is successful

-t 只負責解析與驗證，不會持續啟動 listeners。

啟動

./aster-core -d ./config -f ./config/config.yaml

測試代理：

curl -x http://127.0.0.1:7890 https://example.com/

測試 Controller：

curl \
  -H 'Authorization: Bearer replace-this-controller-secret' \
  http://127.0.0.1:9090/version

重新載入與關閉

Unix：

kill -HUP <pid>   # 重新讀取檔案型設定
kill -TERM <pid>  # 正常關閉

檔案模式的 SIGHUP 會重新讀取磁碟；stdin 或 Base64 模式只會重新套用啟動時保留在記憶體的內容。

快速開始 ​

系統需求 ​

取得 Aster Core ​

從原始碼建置 ​

建立最小設定 ​

驗證設定 ​

啟動 ​

重新載入與關閉 ​

下一步 ​