贡献节点

节点通过 WebSocket 连接中控服务器，领取任务后用自己的 E-Hentai 账号配额完成解析并回报结果。网络的解析能力全部来自志愿者节点。

准备工作

一台能长期在线的设备：NAS、软路由、VPS、常开的电脑都可以，节点程序很轻量。
E-Hentai 账号的 Cookie：登录 e-hentai.org 后从浏览器复制，至少包含 ipb_member_id 和 ipb_pass_hash；非捐赠账号若无法自动进入 ExHentai，还需补上 igneous。可借助工具页的 Cookie 工具提取。
节点凭证：节点用 ED25519 签名认证。到Telegram 频道联系管理员，获取分配给你的 Node ID 和 Signature。

编写 config.yaml

参考配置如下，逐项说明见下表：

config.yaml

# 中控服务器
server:
  url: "wss://api.archive-at-home.org/ws"

# 节点凭证（联系管理员获取）
node:
  id: "node-001"
  signature: "base64-signature"

# E-Hentai 账号
ehentai:
  cookie: "ipb_member_id=xxx; ipb_pass_hash=xxx; igneous=xxx"
  max_gp_cost: -1            # 每日 GP 消耗上限，-1 为不限制

# 任务策略
task:
  gp_cost_willingness: 3     # GP 消耗意愿（1-5），越高越优先接到 GP 任务

# 本地数据（SQLite 解析日志）
database:
  path: "./data/db.db"

# 节点 Dashboard
dashboard:
  enabled: true
  address: ":8090"

配置项	说明
`server.url`	中控服务器的 WebSocket 地址，官方网络为 `wss://api.archive-at-home.org/ws`
`node.id / node.signature`	管理员分配的节点标识与 ED25519 签名（Base64），一对一，请勿混用
`ehentai.cookie`	完整 Cookie 字符串；系统会自动选择可用站点，无需手动指定表站/里站
`ehentai.max_gp_cost`	每日 GP 消耗上限，到达后暂停接 GP 任务，`-1` 不限
`task.gp_cost_willingness`	消耗意愿 1–5：调高更积极地消耗 GP
`database.path`	SQLite 数据库路径，本地保存解析日志
`dashboard.address`	Dashboard 监听地址，默认 `:8090`

启动节点

方式一：Docker Compose（推荐）

从主仓库的 node/ 目录获取 docker-compose.yml，把写好的 config.yaml 放在同目录：

bash

cd node
docker-compose up -d

方式二：二进制

bash

# 从 Releases 下载对应平台的包：https://github.com/Archive-At-Home/archive-at-home/releases
tar -xzf archive-at-home-node-*.tar.gz   # Windows 解压 .zip
cp config.yaml.example config.yaml       # 然后按上一节修改

./archive-at-home-node                   # Windows 运行 .exe

Dashboard

浏览器打开 http://localhost:8090 查看节点 Dashboard：连接状态、任务与 GP 统计、历史累计（从 SQLite 读取），支持手动重连与刷新。显示已连接并开始接收任务即部署成功。

节点与服务器之间的协议：服务器下发 TASK_ASSIGNMENT（画廊 ID + 密钥），节点执行后回报 TASK_RESULT（成功与否、实际 GP、归档链接），并周期性汇报 NODE_STATUS（空闲配额、GP 余额、消耗意愿）供调度参考。

故障排查

现象	排查方向
连接失败	服务器地址是否为 `wss://` 开头；本机网络能否访问 api.archive-at-home.org
认证失败	Node ID 与 Signature 是否来自同一组分配；Signature 的 Base64 是否完整复制
任务持续失败	大概率是 Cookie 失效：重新登录 E-Hentai 复制最新 Cookie，确认含 `ipb_member_id` / `ipb_pass_hash`
GP 消耗异常	检查 `max_gp_cost` 与 `gp_cost_willingness` 设置；Dashboard 可看逐任务消耗

多节点、多地区部署可提高网络的并发能力与稳定性。