常见问题

升级后无法 SSH 连接

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

1. 检查 SSH 服务状态：systemctl status sshd
2. 查看配置文件：cat /etc/ssh/sshd_config

编译依赖缺失

客户端会自动安装编译依赖。如果自动安装失败，请手动安装：

# Ubuntu/Debian
sudo apt-get install -y gcc make autoconf automake libtool

# CentOS/RHEL
sudo yum install -y gcc make autoconf automake libtool

忘记管理员密码

通过数据库重置密码，或删除数据库重建：

docker-compose down
docker-compose up -d

WARNING

数据卷已移除时，首次启动将重新创建默认管理员账户 admin/admin123。

无法访问 Web 服务

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

上传文件失败

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

数据库连接失败

1. 检查数据库容器是否运行：docker-compose ps mysql
2. 检查环境变量 DB_HOST、DB_PASSWORD 等是否正确
3. 查看数据库日志：docker-compose logs mysql

PostgreSQL: permission denied for schema public

PostgreSQL 15+ 对 public schema 的默认权限做了变更，新建用户不再自动获得 CREATE 权限。

使用 PostgreSQL 管理员执行以下 SQL：

GRANT USAGE, CREATE ON SCHEMA public TO ssh_upgrade;