本地开发测试（前后端分离）

本地把前后端都跑起来、跑测试、手工验管理台的完整流程。开发环境 （工具与版本）见 development-environment.md；接口细节见 sign-server-api.md。

起后端（端口 3009）

前端代理写死 127.0.0.1:3009，后端必须在这个端口，否则前端调不通； 要换端口先改 server/web/next.config.js 的代理配置。

1. 准备两个 600 权限的文件（放 /tmp，别进仓库）：
2. 种子文件：测试用，跑 sign-tool gen-keys 取 sign key 行（自己跑工具生成）。
3. 管理员密码文件：自己定一个测试密码。
4. 在仓根跑：

PORT=3009 SIGN_SERVER_DATA_DIR=/tmp/sign-data SIGN_SERVER_SIGNING_SEED_FILE=/tmp/seed-test.txt SIGN_SERVER_ADMIN_PASSWORD_FILE=/tmp/admin-test.txt cargo run --release -p sign-server

也可以先 cargo build --release -p sign-server 再直接跑 target/release/sign-server，环境变量一样。 3. 验：curl http://127.0.0.1:3009/health 应回 ok。

起前端（端口 3000）

cd server/web && npm install（第一次才要），然后 npm run dev （不要加 STATIC_EXPORT，那是静态导出用的）。 打开 http://127.0.0.1:3000/ 登录，登录成功自己进 /dashboard。

跑自动化测试

cargo test --workspace（sign-server 10 + sign-tool 库 22 + sign-tool 命令行 2，共 34 项）。 前端没有自动化测试脚本，靠下面手工验。

手工验管理台（预期结果）

• 登录：错密码 401 显示错误；对密码进 /dashboard。
• 新建打包弹窗：上传带格式 2 版本块的固件 → 下载 pkg + 记录出现； 无版本块的固件 400（文案含 firmware has no version block at bin offset 0x1000）。
• 记录：改备注生效；删除后记录与包文件都没了。
• 调用凭证：弹窗新建，secret 只显示一次，关闭即清；吊销后不可恢复。
• 退出：回登录页。
• 未登录打开 /dashboard：跳登录页（管理台收到 401 自己跳）。
• 测试固件造法见测试流程.html 第一章（sign-tool 本地测试流程）； 版本块格式见 firmware-version-block.md。

调试要点

• 前端改代码自动热重载，不用重启；后端改代码要重启。
• 会话只在后端内存里，重启后端后要重登。
• 前端调不通先查后端是不是在 3009；端口被占时换端口要同步改代理配置。