配置示例与热重载

本页包含开发/生产/Docker 配置示例，以及热重载能力说明。

配置示例

开发环境

# config.toml（开发）
[server]
host = "127.0.0.1"
port = 8080

[database]
database_url = "dev-links.db"

[logging]
level = "debug"

运行时配置（如 features.enable_admin_panel、api.health_token）请通过 Admin API 或 CLI 写入数据库；api.admin_token 请使用 ./shortlinker reset-password 重置。

生产环境

# config.toml
[server]
host = "127.0.0.1"
port = 8080
cpu_count = 8

[database]
database_url = "/data/shortlinks.db"
pool_size = 20

[cache]
type = "memory"
default_ttl = 7200

[cache.memory]
max_capacity = 50000

[logging]
level = "info"
format = "json"
file = "/var/log/shortlinker/app.log"
enable_rotation = true

Docker 环境

Docker 场景建议通过挂载配置文件来设置启动配置（尤其是把 server.host 设为 0.0.0.0）：

# /config.toml（容器内）
[server]
host = "0.0.0.0"
port = 8080

[database]
database_url = "sqlite:///data/shortlinks.db"

运行时配置（写入数据库）可在容器内用 CLI 设置；其中标记为“需要重启”的配置需要重启容器生效：

# 启用管理面板（需要重启）
/shortlinker config set features.enable_admin_panel true

# 配置 Health Bearer Token（无需重启）
/shortlinker config set api.health_token "your_health_token"

热重载

Shortlinker 的“热重载/热生效”主要分两类：

1. 短链接数据同步/热重载：
   • CLI 链接命令（add/update/remove/import/export/list）在服务运行且 IPC 可达时，会通过 IPC 在服务进程内执行。
   • TUI 在本地写库后，会通过 IPC 触发 ReloadTarget::Data 刷新缓存。
2. 运行时配置热生效：
   • Admin API 直接更新“无需重启”的配置时，通常会立即生效。
   • CLI config set/reset 仅在“无需重启”的配置上自动尝试通过 IPC 触发 ReloadTarget::Config。
   • CLI config import 导入后会统一尝试一次 ReloadTarget::Config（best-effort）。

支持热生效/热重载的内容

• ✅ 短链接数据（缓存重建）
• ✅ 标记为“无需重启”的运行时配置（Admin API 或 CLI+IPC）
• ✅ Cookie 配置（api.cookie_*）：对新下发的 Cookie 生效，修改后建议重新登录获取新 Cookie

不支持热重载的配置

• ❌ 服务器地址和端口
• ❌ 数据库连接
• ❌ 缓存类型
• ❌ 路由前缀

检查与手动重载

# 1) 检查 IPC 通信是否正常（用于 CLI/TUI 与服务同步）
./shortlinker status
# 如果你使用了自定义路径：
./shortlinker --socket /tmp/shortlinker.sock status

# 2) 手动重载运行时配置（Admin API）
# 说明：当 IPC 不可达（服务未运行、ipc.enabled=false、socket 路径不一致等）时，
#       CLI config 命令无法通知正在运行的服务，可用该接口手动触发。
#
# 先登录获取 cookies（如已存在 cookies.txt 可跳过）
curl -sS -X POST \
     -H "Content-Type: application/json" \
     -c cookies.txt \
     -d '{"password":"your_admin_token"}' \
     http://localhost:8080/admin/v1/auth/login

CSRF_TOKEN=$(awk '$6=="csrf_token"{print $7}' cookies.txt | tail -n 1)

curl -X POST \
     -b cookies.txt \
     -H "X-CSRF-Token: ${CSRF_TOKEN}" \
     http://localhost:8080/admin/v1/config/reload