常见问题
❓ 常见问题解答
遇到问题？先看看这里
🐳 部署相关
Docker 容器无法启动？
1. 检查端口是否被占用
bash
lsof -i:80002. 查看容器日志
bash
docker logs navlink-app3. 确保数据目录权限正确
bash
chmod -R 755 data plugins logs忘记管理员密码？
删除认证数据库重新初始化：
bash
# 停止容器
docker stop navlink-app
# 删除认证数据库
rm data/auth.db
# 重启容器（会使用默认密码 admin123）
docker start navlink-app⚠️ 这将重置所有用户账户！其他数据不受影响。
如何备份数据？
方式一：后台导出
登录后台 → 数据管理 → 导出配置
方式二：命令行备份
bash
# 停止容器
docker stop navlink-app
# 备份整个 data 目录
tar -czvf navlink-backup-$(date +%Y%m%d).tar.gz data/
# 重启容器
docker start navlink-app升级后需要重新激活？
确保 docker-compose.yml 中配置了固定的 hostname：
yaml
services:
navlink:
image: ghcr.io/txwebroot/navlink-releases:latest
hostname: navlink-app # 必须固定！这样升级后容器指纹不会变化，无需重新激活。
🔧 功能相关
搜索没有结果？
- ✅ 确保已添加链接分类和链接
- ✅ 检查搜索关键词是否匹配标题或描述
- ✅ 拼音搜索需要输入完整拼音或首字母
AI 对话报错？
- ✅ 检查 API Key 是否正确
- ✅ 确认 Base URL 格式（需包含
/v1） - ✅ 检查网络连接（部分 API 可能需要代理）
常用配置：
| 提供商 | Base URL |
|---|---|
| DeepSeek | https://api.deepseek.com/v1 |
| OpenAI | https://api.openai.com/v1 |
插件安装失败？
- ✅ 确保
plugins目录已挂载 - ✅ 检查磁盘空间是否充足
- ✅ 查看后台日志获取详细错误
bash
docker logs navlink-app --tail 50链接健康检测不准确？
部分网站有反爬机制，可能误判为失效。可以：
- 手动标记为健康
- 排除特定域名
- 调整检测超时时间
⚡ 性能优化
响应缓慢怎么办？
- ✅ 检查服务器配置（建议 1GB+ 内存）
- ✅ 减少首页显示的链接数量
- ✅ 关闭不使用的插件
- ✅ 启用 Redis 缓存（可选）
数据库过大怎么办？
清理历史日志：
bash
docker exec -it navlink-app sh -c "rm -rf logs/*"📌 其他问题
如何修改端口？
修改 docker-compose.yml：
yaml
ports:
- "8080:3002" # 改为新端口然后重启：
bash
docker compose up -d如何查看版本号？
- 登录后台 → 系统设置 → 系统升级
- 或查看容器镜像：
docker inspect navlink-app | grep Image