常见问题
安装
Q：可以不装数据库直接用吗？ A：可以。选 SQLite（个人使用 / 测试），数据文件落在 config/ 目录，容器部署记得挂载该目录。
Q：默认端口是多少？能改吗？ A：默认 12395。容器用 -p 8080:8080 -e GOPANEL_PORT=8080；二进制用 GOPANEL_PORT 或配置文件 server.port。
Q：需要额外配置站点端口吗？ A：不需要，也不支持。程序是单一监听端口的管理后台，站点 / HTTPS 由外部 Nginx / Caddy 反代承载。
Q：arm64 机器能用 latest 镜像吗？ A：可以，latest / <tag> 是多架构（amd64 / arm64 / arm/v7）。只有 dev 标签是 arm64 单架构。
登录与账号
Q：能注册账号吗？ A：不能。系统不提供注册功能，账号由管理员在后台创建。
Q：忘记管理员密码怎么办？ A：./GoPanel -rp（容器内 docker exec gopanel /home/gopanel/GoPanel -rp）。 详见 安装向导与账号。
Q：忘记安全入口（随机登录路径）怎么办？ A：./GoPanel -se 打印，./GoPanel -sr 重置并打印新地址。
Q：登录提示 429？ A：触发了登录失败锁定（默认 3 次失败锁 5 分钟），到「设置 → IP 黑名单」解锁。
功能
Q：面板能管理系统上的 Caddy / Nginx 吗？ A：能。站点服务以 Caddy 为内核，配置与二进制路径可在「设置 → 服务路径」调整。
Q：容器里为什么看不到宿主机的端口和进程？ A：需要挂载宿主机根目录并共享 PID 命名空间：-v /:/host:ro --pid=host。
Q：容器导出的 compose 能直接用吗？ A：编排创建的容器导出的是完整原始 yml，可直接 docker compose up -d； 独立容器是按 docker inspect 反推的，包内会标注「需人工确认」项。
Q：应用商店的应用带安装脚本吗？ A：不带。安装与卸载由面板原生执行（docker compose up -d / down），数据卷默认保留。
运维
Q：如何升级？ A：容器重新 pull + run；二进制重新执行安装脚本或替换文件。详见 升级与备份。
Q：主密钥是干什么的？必须备份吗？ A：用于加密堡垒机凭据、DNS 账号密钥与安全码。必须备份，与数据库配套；换了密钥旧密文全部失效。
Q：日志在哪儿？ A：data/logs/（可用 GOPANEL_LOG_DIR 修改），容器内用 docker logs 查看。
Q：数据存在哪里？ A：数据库 + config/（配置、SQLite 文件、master.key）+ data/（日志、证书私钥）。