配置参考¶
优先级:环境变量 > config.toml > 默认值。生成配置文件用
linklist init(完整字段与注释见生成的 config.toml 与
config.toml.example)。
全量字段¶
| 配置项 | 环境变量 | 默认值 | 说明 |
|---|---|---|---|
| database_url | LINKLIST_DATABASE_URL(兼容 DATABASE_URL,前者优先) |
空 | 数据库连接串;前缀决定后端,见数据库 |
| listen | LINKLIST_LISTEN |
0.0.0.0:9090 |
HTTP 监听地址 |
| data_dir | LINKLIST_DATA_DIR |
./data |
SQLite 数据库与快照/资产存储目录 |
| log | LINKLIST_LOG |
info |
日志级别(RUST_LOG 语法) |
| session_ttl_secs | LINKLIST_SESSION_TTL |
604800 |
会话不活动过期(秒) |
| token_ttl_days | LINKLIST_TOKEN_TTL |
0 |
API Token 有效期(天,0 = 永久) |
| admin_password | LINKLIST_ADMIN_PASSWORD |
无 | 预置管理员口令(仅库中无用户时生效;Docker 首启与 init 共用) |
| guest_sharing | LINKLIST_GUEST_SHARING |
false |
匿名访客可见公开共享书签 |
| login_max_failures | LINKLIST_LOGIN_MAX_FAILURES |
10 |
登录失败限速阈值 |
| login_window_secs | LINKLIST_LOGIN_WINDOW |
300 |
限速窗口(秒) |
| fetch_timeout_secs | LINKLIST_FETCH_TIMEOUT |
30 |
抓取超时(秒) |
| fetch_max_bytes | LINKLIST_FETCH_MAX_BYTES |
5242880 |
抓取响应大小上限(字节) |
| fetch_max_redirects | LINKLIST_FETCH_MAX_REDIRECTS |
5 |
抓取重定向上限 |
| allowed_internal_hosts | LINKLIST_ALLOWED_INTERNAL_HOSTS |
[] |
SSRF 防护下的内网主机白名单(逗号分隔) |
| enable_oidc | LINKLIST_ENABLE_OIDC |
false |
启用 OIDC 单点登录 |
| oidc_* | LINKLIST_OIDC_* |
无 | OIDC 端点与客户端配置(见 config.toml.example) |
| enable_auth_proxy | LINKLIST_ENABLE_AUTH_PROXY |
false |
反向代理认证模式 |
| cors_allowed_origins | LINKLIST_CORS_ALLOWED_ORIGINS |
[] |
CORS 允许来源 |
| disable_url_validation | LINKLIST_DISABLE_URL_VALIDATION |
false |
禁用书签 URL 格式校验 |
| enable_snapshots | LINKLIST_ENABLE_SNAPSHOTS |
false |
启用 HTML 快照功能 |
| disable_asset_upload | LINKLIST_DISABLE_ASSET_UPLOAD |
false |
禁用资产/快照上传 |
| disable_login_form | LINKLIST_DISABLE_LOGIN_FORM |
false |
禁用密码登录表单(纯 SSO 部署) |
| disable_background_tasks | LINKLIST_DISABLE_BACKGROUND_TASKS |
false |
禁用后台任务(metadata/snapshot/archive_lookup/preview) |
数据目录¶
data_dir 存放:
- SQLite 模式下的数据库文件
linklist.db(含-wal/-shm); - 网页快照、预览图、favicon 缓存、上传资产等文件。
无论使用哪种数据库,快照与资产文件都写在本地数据目录——外部数据库 (PostgreSQL/MySQL)部署时该目录仍需持久化。