xboard-node/CLAUDE.md

xboard-node fork 运维手册

仓库说明

JP01 Gitea 自维护 fork，不是上游镜像，独立分支。

• 本仓库：http://103.112.1.141:3000/will/xboard-node（dev 分支）
• 上游（仅供 cherry-pick 参考）：https://github.com/cedar2025/Xboard-Node
• 工作目录：/tmp/xboard-node（JP01）

---

已应用补丁

补丁	文件	说明	是否可移除
#32	internal/service/service.go	ban 用户前调 CloseUserConnections()，立即断连	待上游合并后移除
#55	internal/kernel/singbox/conntracker.go	UDP PacketConn upload/download 计数对调	待上游合并后移除
自改	cmd/xbctl/main.go	downloadBase 指向 JP01 Gitea releases	永久保留
自改	cmd/xbctl/main.go	downloadToken + downloadFile 加 Authorization header，支持 private 仓库下载	永久保留
自改	install.sh	binary 下载地址改为 JP01 Gitea releases	永久保留

xbctl private 仓库下载（2026-06-24）

背景：Gitea 仓库改为 private 后，xbctl upgrade 下载时 HTTP 401。

改动位置：cmd/xbctl/main.go

// 新增常量
downloadToken = "cf6634b57d2c60c66030dbb29d77c4ed25370e94"

// downloadFile 改用 NewRequest，加 Authorization header
func downloadFile(url, dest string) error {
    client := &http.Client{Timeout: 120 * time.Second}
    req, err := http.NewRequest("GET", url, nil)
    if err != nil {
        return err
    }
    if downloadToken != "" {
        req.Header.Set("Authorization", "token "+downloadToken)
    }
    resp, err := client.Do(req)
    ...
}

注意：token 是只读 read:repository 权限，泄露只能读仓库，不能写。

---

编译命令

cd /tmp/xboard-node
VERSION=$(git describe --tags --always --dirty)

# xboard-node（必须带这些 tags）
CGO_ENABLED=0 /usr/local/go/bin/go build \
  -ldflags "-s -w -X main.version=${VERSION}" \
  -tags "with_quic with_utls with_wireguard with_acme with_clash_api" \
  -o xboard-node-linux-amd64 ./cmd/xboard-node/

# xbctl
CGO_ENABLED=0 /usr/local/go/bin/go build \
  -ldflags "-s -w" \
  -o xbctl-linux-amd64 ./cmd/xbctl/

---

发布流程

TOKEN=cf6634b57d2c60c66030dbb29d77c4ed25370e94
RELEASE_ID=14  # v1.13-patched

# 删旧 asset
OLD_ID=$(curl -s "http://localhost:3000/api/v1/repos/will/xboard-node/releases/$RELEASE_ID/assets" \
  -H "Authorization: token $TOKEN" | python3 -c "
import sys,json
for a in json.load(sys.stdin):
    if a['name'] == 'xboard-node-linux-amd64': print(a['id'])")
curl -s -X DELETE "http://localhost:3000/api/v1/repos/will/xboard-node/releases/$RELEASE_ID/assets/$OLD_ID" \
  -H "Authorization: token $TOKEN"

# 上传新 asset
curl -s -X POST "http://localhost:3000/api/v1/repos/will/xboard-node/releases/$RELEASE_ID/assets?name=xboard-node-linux-amd64" \
  -H "Authorization: token $TOKEN" -H "Content-Type: application/octet-stream" \
  --data-binary @xboard-node-linux-amd64

---

节点部署

节点	IP	MCP
dmit-tyo	154.31.113.157	mcp__dmit-tyo__exec
us-unlock	103.152.113.30	mcp__us-unlock__exec
vmiss-us01	38.47.112.162	mcp__vmiss-us04__exec

节点上执行升级：

xbctl upgrade  # 自动带 token，直接用