配置与部署

配置加载机制

配置通过 figment 加载，支持多层来源，后者覆盖前者：

1. JH_CONFIG 环境变量 → 指向一个 TOML 文件路径
2. --config / -c CLI 参数 → 指定 TOML 配置文件路径
3. JH_* 环境变量 → 字段名转大写加 JH_ 前缀，如 database_url → JH_DATABASE_URL
4. -O key=value CLI 参数 → 直接覆盖（TOML 语法）

# 方式一：指定配置文件
./server --config=application-dev.toml

# 方式二：环境变量
JH_CONFIG=/etc/job-hunting/server.toml ./server

# 方式三：覆盖单个字段
./server -O database_url="postgres://localhost/mydb" -O port=8080

配置项参考

以下为 config 结构体中的全部字段，默认值即不做配置时的值。

Server

Database

Auth

生产环境必须修改: auth_access_token_secret、auth_refresh_token_secret

Task

Logging

完整配置示例

server_name = "job-hunting"
address = "0.0.0.0"
port = 3000

database_url = "postgres://user:password@localhost:5432/job_hunting"

# 生产环境务必修改以下两项
auth_access_token_secret = "your-long-secret-string"
auth_access_token_expires_in = 28800
auth_refresh_token_secret = "your-another-secret-string"
auth_refresh_token_expires_in = 15897600

log_console_enabled = true
log_console_level = "info"
log_file_enabled = true
log_file_level = "debug"
log_file_directory = "/var/log/job-hunting"
log_file_rotation = "daily"

数据库迁移

迁移由 Sea-ORM 管理，在服务器启动时自动执行，无需手动干预：

// api/src/lib.rs - api::start() 中
migration::Migrator::up(&conn, None).await?;

也可手动执行迁移 CLI：

# 在 migration 目录下
cargo run -- up

迁移文件位于 migration/src/，按时间命名：

• m20260000_000000_init.rs — 初始建表
• m20260605_000001_add_indexes.rs — 索引补充

Docker 部署

构建镜像

# 交叉编译二进制（由 CI 负责）
# 构建 Docker 镜像
docker build -t job-hunting-server -f apps/server/Dockerfile .

Dockerfile（简化版）

FROM alpine:3.20.2
WORKDIR /app
COPY target/release/job-hunting-server /app/server
EXPOSE 3000
CMD ["./server"]

docker-compose（PostgreSQL 本地开发）

项目中提供了 docker-compose.yml，仅包含 PostgreSQL 服务：

cd apps/server
docker compose up -d    # 启动 PostgreSQL

修改配置指向本地 PostgreSQL：

./server -O database_url="postgres://postgres:changeme@127.0.0.1:5432/postgres"

运行时控制

CLI 参数

./server --help

# 可选参数：
#   -c, --config <FILE>      指定配置文件（可多次指定）
#   -O <KEY=VALUE>          覆盖配置项（TOML 语法）

信号（Linux/macOS）

moon 任务