常见问题
升级后无法 SSH 连接
程序内置守护机制,会自动检测并恢复 SSH 配置。如需手动排查:
- 检查 SSH 服务状态:
systemctl status sshd - 查看配置文件:
cat /etc/ssh/sshd_config
编译依赖缺失
客户端会自动安装编译依赖。如果自动安装失败,请手动安装:
bash
# Ubuntu/Debian/麒麟(桌面版)
sudo apt-get install -y gcc make autoconf automake libtool libssl-dev zlib1g-dev libpam0g-dev libselinux1-dev libkrb5-dev pkg-config
# CentOS/RHEL/麒麟(服务器版)
sudo yum install -y gcc gcc-c++ make autoconf automake libtool openssl-devel zlib-devel pam-devel libselinux-devel krb5-devel pkgconfig忘记管理员密码
通过数据库重置密码,或重建容器后重新通过初始化引导页设置:
bash
docker-compose down -v
docker-compose up -dWARNING
使用 -v 参数会删除数据卷(包括数据库数据),首次访问将重新进入初始化引导页,可重新设置管理员账号。
无法访问 Web 服务
- 检查防火墙是否开放端口
- 检查容器是否正常运行:
docker-compose ps - 查看日志:
docker-compose logs -f
上传文件失败
- 检查上传目录的权限
- 确保文件格式为
.tar.gz - 检查磁盘空间是否充足
数据库连接失败
- 检查数据库容器是否运行:
docker-compose ps mysql - 检查环境变量
DB_HOST、DB_PASSWORD等是否正确 - 查看数据库日志:
docker-compose logs mysql
PostgreSQL: permission denied for schema public
PostgreSQL 15+ 对 public schema 的默认权限做了变更,新建用户不再自动获得 CREATE 权限。
使用 PostgreSQL 管理员执行以下 SQL:
sql
GRANT USAGE, CREATE ON SCHEMA public TO ssh_upgrade;