常见问题
这里汇总了用户经常遇到的问题和解答，如果您的问题不在列表中，欢迎提交 Issue。
Docker 启动失败，提示找不到配置文件？
这是因为容器内没有正确挂载配置文件。请确保使用 -v 参数挂载配置文件：
docker run -d \
-p 8080:8080 \
-v /your/path/config.yaml:/app/config/config.yaml \
ydcloud/opshub:latest配置文件需要提前准备好，可以从项目中复制 config/config.example.yaml 并修改。
数据库连接失败怎么办？
请检查以下几点：
1. 确认 MySQL 服务已启动并可访问
2. 检查配置文件中的数据库连接信息是否正确
3. 如果使用 Docker，确保网络配置正确（使用 host.docker.internal 或容器网络）
4. 确认数据库用户有足够的权限
前端构建失败，npm install 报错？
可能是 Node.js 版本过低或网络问题导致。建议：
1. 确保 Node.js 版本 >= 18
2. 尝试使用国内镜像源：
npm config set registry https://registry.npmmirror.com
npm install3. 如果仍然失败，删除 node_modules 和 package-lock.json 后重试。
添加 Kubernetes 集群失败？
常见原因和解决方案：
1. KubeConfig 格式错误：确保粘贴的是完整的 kubeconfig 内容
2. 网络不通：确保 OpsHub 服务器能访问 Kubernetes API Server
3. 证书问题：如果是自签名证书，确保 kubeconfig 中包含正确的 CA 证书
4. 权限不足：确保 kubeconfig 中的用户有足够的集群访问权限
Web 终端连接超时？
Web 终端使用 WebSocket 连接，请检查：
1. 确保浏览器支持 WebSocket
2. 如果使用了反向代理（Nginx），需要配置 WebSocket 支持：
location /ws/ {
proxy_pass http://backend;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
}3. 检查防火墙是否允许 WebSocket 连接
如何管理多个 Kubernetes 集群？
OpsHub 原生支持多集群管理：
1. 在「集群管理」页面添加多个集群
2. 每个集群使用独立的 kubeconfig
3. 在各功能页面通过顶部的集群选择器切换当前操作的集群
4. 支持跨集群的资源搜索和对比
忘记管理员密码怎么办？
可以通过数据库直接重置密码：
-- 连接到 MySQL
mysql -u root -p opshub
-- 重置 admin 用户密码为 admin123
UPDATE sys_users SET password = '$2a$10$...' WHERE username = 'admin';或者使用命令行工具重置：
./opshub reset-password --username admin --password newpassword