类型：服务器管理面板
简介：1Panel是一个现代化、开源的Linux服务器运维管理面板。
应用启动失败时，很多人第一反应是删除重装，但这往往会掩盖真正原因。1Panel容器日志能直接显示应用启动过程、依赖连接、端口监听、配置读取和错误堆栈。只要日志还能输出，就应该先读日志，再决定是否修改配置、调整端口或重建容器。盲目重装可能导致数据目录被覆盖、数据库连接信息丢失，甚至把原本简单的端口冲突变成数据恢复问题。
第一步：找到对应容器和最新日志
进入1Panel容器管理页面，先确认哪个容器异常。状态显示退出、反复重启、健康检查失败或运行中但页面打不开，都需要查看日志。
打开容器日志后，优先看最后几十行，因为最新错误通常出现在末尾。如果日志滚动很快，可以暂停刷新或复制关键部分。
不要只截取一行报错，最好连同报错前后的启动信息一起看，例如读取配置、连接数据库、绑定端口、加载插件这些上下文。
第二步：判断应用是否真正启动
日志中如果出现 listening、server started、ready、running 等信息，通常说明应用已经启动；如果随后又出现 exit、fatal、panic、permission denied、connection refused 等内容，则说明启动后遇到错误退出。若容器一直重启，可以查看重启前最后一段日志。应用启动失败不一定是程序坏了，也可能是数据库没启动、配置文件路径不对、端口被占用、磁盘满了或环境变量缺失。先判断“没启动起来”还是“启动了但访问不到”，排查方向完全不同。
第三步：排查端口冲突
端口冲突是1Panel部署应用时常见问题。日志里如果出现 address already in use、bind failed、port is already allocated 等提示，说明要使用的端口已经被其他服务占用。此时可以在1Panel容器列表、网站列表或服务器命令中查看端口占用。解决方式有两种：修改当前应用映射端口，或停止占用端口的旧服务。不要随意关闭不认识的服务，尤其是数据库、Web服务器和面板相关进程。修改端口后，还要同步检查反向代理目标、域名访问地址和防火墙放行规则。
第四步：排查环境变量错误
很多容器应用依赖环境变量，例如数据库地址、账号密码、密钥、站点URL、API地址和运行模式。日志里如果出现 missing environment variable、invalid config、secret required、database url empty 等提示，基本可以判断配置项缺失或格式错误。
进入1Panel应用或容器配置页面，核对变量名是否拼写正确，变量值是否包含多余空格，URL是否带协议，密码里特殊字符是否被错误解析。修改环境变量后，需要重启容器才能生效。正式环境不要把密钥写到公开文档或截图里。
第五步：排查数据库连接失败
如果日志出现 connection refused、access denied、unknown database、timeout 等数据库相关错误，先确认数据库容器或数据库服务是否运行。connection refused 多表示地址或端口不可达；access denied 通常是用户名、密码或权限错误；unknown database 表示数据库名不存在；timeout 可能是网络、容器网络或防火墙问题。若应用和数据库都在容器里，注意数据库地址通常不是 127.0.0.1，而可能是数据库容器名或内部网络地址。
第六步：排查权限和目录挂载
日志里出现 permission denied、read-only file system、cannot write、no such file or directory 时，要检查挂载目录和文件权限。
应用需要写入 uploads、cache、logs、data 等目录，如果宿主机目录权限不允许容器写入，就会启动失败或运行异常。
先确认目录存在，再查看所有者和权限。不要为了省事给整个服务器目录设置过宽权限，可以只调整应用需要写入的目录。
若是路径写错，容器可能会创建空目录，导致应用看起来启动了，但实际没有读到原有数据。
第七步：形成排查顺序
建议按“容器状态—最新日志—端口—环境变量—数据库—目录权限—镜像版本”的顺序排查。
每次只改一个变量，改完重启并再次看日志，这样才能知道哪一步解决了问题。排查完成后，把最终原因和修改项记录下来，例如“端口3000被旧服务占用，改为3001并同步反向代理”。长期来看，学会看1Panel容器日志，比记住某一个报错答案更有价值，因为不同应用的报错文本不同，但排查逻辑基本相通。
FAQ
问：容器一直重启应该怎么看日志？
答：查看重启前最后几十行日志，重点找 fatal、error、panic、permission denied、address already in use 等关键词。
问：容器运行中但网页打不开怎么办？
答：先确认应用日志显示已监听端口，再检查端口映射、反向代理目标、防火墙和域名解析。
