常见问题

管理员账号和密码

默认管理员密码是什么？

默认用户名：root，默认密码：123456

重要：首次登录后请立即前往「个人设置」修改密码！

如何重置管理员密码？

# 停止服务
docker stop llm-gateway

# 进入容器
docker exec -it llm-gateway sh

# 使用内置命令重置密码
./llm-gateway --reset-root-password

# 重启服务
docker restart llm-gateway

部署和配置

支持哪些数据库？

SQLite（默认，适合小规模部署）
MySQL 5.7+（推荐用于生产环境）
PostgreSQL 12+（推荐用于生产环境）

通过环境变量 SQL_DSN 配置数据库连接。

端口 3000 已被占用怎么办？

使用 --port 参数或 PORT 环境变量指定其他端口：

# 命令行参数
./llm-gateway --port 8080

# Docker 环境变量
docker run -d -p 8080:8080 -e PORT=8080 deepcells/llm-gateway:latest

如何备份数据？

SQLite：备份 data/llm-gateway.db 文件

MySQL/PostgreSQL：使用数据库自带的备份工具

# MySQL
mysqldump -u user -p llm_gateway > backup.sql

# PostgreSQL
pg_dump -U user llm_gateway > backup.sql

许可证相关

试用许可证到期后会怎样？

系统会进入只读模式：

✅ 可以查看所有数据和配置
✅ 可以登录和使用 API
❌ 无法创建、更新、删除任何资源

详见许可证管理了解如何升级。

功能使用

如何使用智能路由？

在 API 请求中添加 X-Route-Strategy 头：

curl http://localhost:3000/v1/chat/completions \
  -H "Authorization: Bearer sk-xxxxxx" \
  -H "X-Route-Strategy: cost" \
  -H "Content-Type: application/json" \
  -d '{"model": "deepseek-chat", "messages": [...]}'

支持的策略：

cost：成本优化
performance：性能优先
load_balance：负载均衡
balanced：综合平衡

详见智能路由文档。

如何启用语义缓存？

安装 Redis Stack（支持向量搜索）：

docker run -d --name redis-stack -p 6379:6379 redis/redis-stack:latest

在「系统设置」→「语义缓存」中配置：
- Redis 连接：redis://localhost:6379
- Embedding 模型和 API
- 相似度阈值（推荐 0.85）

详见语义缓存文档。

如何启用 Prompt 防火墙？

进入「防火墙」→「规则管理」
点击「初始化默认规则」
根据需要启用相应规则：
- PII 脱敏（推荐）
- Prompt 注入拦截（推荐）
- SQL 注入、XSS 拦截（谨慎启用）

详见 Prompt 防火墙文档。

故障排除

容器启动失败怎么办？

检查端口是否被占用：
```
lsof -i :3000
```
查看容器日志：
```
docker logs llm-gateway
```
检查数据目录权限：
```
ls -la ./data
```

API 调用失败怎么办？

检查令牌是否有效：
- 在「令牌管理」页面确认令牌状态
- 检查令牌额度是否耗尽
检查渠道配置：
- 在「渠道管理」页面测试连接
- 确认 API Key 有效
查看访问日志：
- 在「访问日志」页面查看详细错误信息

如何查看详细日志？

# 查看容器日志
docker logs llm-gateway

# 进入容器查看文件日志
docker exec -it llm-gateway sh
ls -la /app/logs/

# 查看特定日志文件
docker exec -it llm-gateway cat /app/logs/system.log

需要更多帮助？

如果以上问题没有解决您的疑问，请：

查看详细部署文档

管理员账号和密码​

部署和配置​

许可证相关​

功能使用​

故障排除​

管理员账号和密码

部署和配置

许可证相关

功能使用

故障排除