S-UI项目Docker部署常见问题分析与解决方案

容器化部署的404错误排查

在使用Docker Compose部署S-UI 1.2.2版本时，部分用户会遇到访问面板时出现HTTP 404错误的情况。从日志分析可见，虽然服务已正常启动（监听2095/2096端口），但前端资源访问异常。

根本原因在于S-UI采用了特定的基础路径(app)设计。正确的访问方式应为：

http://服务器IP:2095/app

典型错误表现：

1. 直接访问根路径(/)返回404
2. 容器日志显示服务正常启动但无法访问界面
3. 浏览器开发者工具显示静态资源加载失败

镜像构建时的内存溢出问题

在自定义构建Docker镜像过程中，用户可能遇到Node.js内存溢出的致命错误：

FATAL ERROR: Ineffective mark-compacts near heap limit Allocation failed

这是由于构建环境内存不足导致，特别是在低配服务器或资源受限的CI/CD环境中常见。解决方案包括：

1. 提升构建环境资源配置（建议至少4GB可用内存）
2. 通过Node.js参数调整内存限制：

export NODE_OPTIONS="--max-old-space-size=4096"

3. 分阶段构建Docker镜像，减少单次构建压力

最佳实践建议

1. 生产环境部署：

• 优先使用官方预构建镜像
• 确保暴露正确的端口(2095/TCP)
• 配置反向代理时保留/app路径前缀

2. 开发环境构建：

• 在x86_64架构设备上构建
• 设置交换分区缓解内存压力
• 使用多阶段构建减少最终镜像体积

3. 日志分析要点：

• "sing-box started"表示核心服务就绪
• 网络接口变更可能影响容器通信
• syslog错误通常不影响主要功能

通过以上方案，可以解决大多数S-UI容器化部署中的典型问题。对于持续出现的问题，建议检查宿主机的防火墙/SELinux设置以及Docker网络配置。