常见问题与故障排查
安装、启动、agent 对话过程中的常见问题。
端口被占用怎么办
niuniu 默认监听 3000。可以通过 ~/.niuniu/config.yaml 修改：
server:
host: 127.0.0.1
port: 3001或环境变量 NIUNIU_SERVER_PORT=3001。
SQLite 锁错误
如果看到 database is locked，通常是上次进程没干净退出。
- 检查是否还有
niuniu/niuniu-server进程：ps aux | grep niuniu，杀掉。 - 删除 lock 文件：
rm ~/.niuniu/niuniu.db-shm ~/.niuniu/niuniu.db-wal（数据本身在niuniu.db，不要删）。 - 如果同时跑 ≥ 3 个 workspace，建议切到 PostgreSQL（见 Self-Hosted 安装）。
claude 命令找不到
niuniu 通过 claude CLI 与 Anthropic 通信，需要先安装 Claude CLI。
# 验证安装
claude --version如果命令不在 PATH，在 ~/.niuniu/config.yaml 显式指定：
agent:
claude_cli_path: /Users/me/.local/bin/claude关闭认证
开发自用场景可以关闭认证，编辑 ~/.niuniu/config.yaml：
auth:
enabled: false重启 niuniu 即可。注意：不要在生产环境关认证。
数据文件位置
- 配置：
~/.niuniu/config.yaml - SQLite 数据库：
~/.niuniu/niuniu.db - 多租户子目录：
~/.niuniu/{users,orgs}/<id>/{workspaces,repositories}/
还没找到答案？
提一个 GitHub issue 或在团队版控制台联系我们。