# go-dy 部署说明

本文档介绍如何在 Linux 与 Windows 服务器上部署。

## 1. 准备
- 数据库：确保 `DB_DSN` 可用（例如：`user:pass@tcp(host:3306)/db?parseTime=true&charset=utf8mb4`）。
- 端口：默认 `PORT=8080`，可改为需要的端口。
- JWT 密钥：设置 `JWT_SECRET` 为强随机字符串。
- 验证码：
  - 登录验证码由 `LOGIN_REQUIRE_CAPTCHA` 控制（默认 true）。
  - 注册验证码由 `REGISTER_REQUIRE_CAPTCHA` 控制（默认 true）。

## 2. 文件构成
- 二进制：`go-dy-linux-amd64` 或 `go-dy-linux-arm64` 或 `go-dy-windows-amd64.exe`
- 配置：`.env`（可参考 `.env.example`）

## 3. Linux（systemd）
1. 新建工作目录（例如 `/opt/go-dy`），上传二进制与 `.env`。
2. 赋予执行权限：`chmod +x /opt/go-dy/go-dy-linux-amd64`
3. 创建 systemd 单元：`/etc/systemd/system/go-dy.service`

   参考模板见 `deploy/systemd/go-dy.service`，根据架构与路径调整：
   - `ExecStart` 指向二进制
   - `WorkingDirectory` 指向 `.env` 所在目录

4. 加载与启动：
   - `sudo systemctl daemon-reload`
   - `sudo systemctl enable go-dy`
   - `sudo systemctl start go-dy`
   - `sudo systemctl status go-dy`

5. 查看日志：`journalctl -u go-dy -f`

## 4. Windows（服务/常驻）
- 方式 A：使用 NSSM 注册为服务（推荐）。
  1. 安装 NSSM。
  2. `nssm install go-dy C:\path\to\go-dy-windows-amd64.exe`
  3. 设置 `Startup directory` 指向 `.env` 所在目录。
  4. 启动服务：`nssm start go-dy`

- 方式 B：任务计划程序或 PowerShell 常驻：
  - PowerShell：`Start-Process -NoNewWindow -WorkingDirectory C:\path\to -FilePath C:\path\to\go-dy-windows-amd64.exe`

## 5. 环境变量
将以下键放入 `.env` 或服务器环境中：
```
PORT=18080
JWT_SECRET=请替换为强随机密钥
DB_DSN=user:pass@tcp(host:3306)/db?parseTime=true&charset=utf8mb4
ALLOW_REGISTRATION=true
LOGIN_REQUIRE_CAPTCHA=false
REGISTER_REQUIRE_CAPTCHA=false
```

## 6. 健康与验证
- 启动后日志应包含：数据库连接成功与监听端口。
- 登录：`POST /api/login`（表单 `name`, `password`）。
- 注册：`POST /api/register`（字段随验证码开关而异）。

## 7. 迁移与数据
- 用户表需包含 `password_hash`（bcrypt）。
- 可使用 `tools/update_password.go` 脚本按需写入 bcrypt 密码。