Skip to content

常见问题

升级后无法 SSH 连接

程序内置守护机制,会自动检测并恢复 SSH 配置。如需手动排查:

  1. 检查 SSH 服务状态:systemctl status sshd
  2. 查看配置文件: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 -d

WARNING

使用 -v 参数会删除数据卷(包括数据库数据),首次访问将重新进入初始化引导页,可重新设置管理员账号。

无法访问 Web 服务

  1. 检查防火墙是否开放端口
  2. 检查容器是否正常运行:docker-compose ps
  3. 查看日志:docker-compose logs -f

上传文件失败

  1. 检查上传目录的权限
  2. 确保文件格式为 .tar.gz
  3. 检查磁盘空间是否充足

数据库连接失败

  1. 检查数据库容器是否运行:docker-compose ps mysql
  2. 检查环境变量 DB_HOSTDB_PASSWORD 等是否正确
  3. 查看数据库日志: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;