容器化部署微服务，真正麻烦的从来不是拉镜像或点按钮，而是每个组件对环境变量、启动参数、网络监听地址的隐式约定——这些细节不会出现在宝塔界面上，只能靠日志和命令行一层层剥开。说实话，很多卡住的地方，翻来覆去就是那么几个原因。
根本原因往往是Docker服务没启动，或者当前用户不在docker组。先执行sudo systemctl status docker看看状态，如果是inactive，启动并设置自启；否则执行sudo usermod -aG docker $USER，然后彻底退出SSH重新登录。
宝塔面板里装Docker管理器失败，docker version 报错“Cannot connect to the Docker daemon”
明明插件装好了，怎么 docker version 还报错？别急——宝塔的Docker管理器插件只管界面，底层服务还得自己手动确认。先走终端：sudo systemctl status docker，看是不是 active (running)。如果不是，启动它并设置自启：sudo systemctl start docker && sudo systemctl enable docker。如果状态正常但命令还是报错，说明当前用户不在 docker 用户组，执行 sudo usermod -aG docker $USER，然后退出SSH重新登录。记住，宝塔面板里的“Docker管理器”插件本身不提供命令行入口，所有验证和排错都得靠终端搞定。
拉取 Nacos 镜像后创建容器，MODE=standalone 不生效，日志一直卡在 cluster 初始化
这个坑踩的人不少。官方 nacos/nacos-server 镜像从 v2.2.0 起默认走集群模式，MODE=standalone 只对 v1.x 和部分早期 v2.x 有效；v2.3+ 必须显式指定 JVM 参数或改用 NACOS_APPLICATION_MODE。具体怎么做？
- v2.3.2 及以上版本，环境变量应设为
NACOS_APPLICATION_MODE=standalone，不是MODE。 - 如果还不行，直接在创建容器时追加启动命令：
bin/startup.sh -m standalone。 - 挂载配置目录时，确保
/www/docker/nacos/conf/application.properties中包含nacos.core.mode=standalone。 - 别依赖宝塔界面上的“环境变量”输入框自动补全——它不会校验键名合法性，输错了就默默忽略，连个提示都没有。
端口映射配了 8848→8848，但从外网访问不到 Nacos 控制台
端口映射看着没问题，但外网就是打不开？三个环节缺一不可：宿主机防火墙、宝塔安全组、容器内部监听地址。一个个排查：
- 先确认容器内 Nacos 真的监听了
0.0.0.0:8848，不是127.0.0.1:8848（查日志或进容器执行netstat -tuln | grep 8848）。 - 宝塔面板 → 安全 → 放行端口，手动添加
8848（TCP），别只信“放行常用端口”那个勾选项。 - 宿主机系统防火墙（如
ufw或firewalld）也要放行。宝塔安全组只管面板自身规则，管不到系统级防火墙。 - 云服务器（阿里云/腾讯云）还得在控制台安全组里单独放行该端口——宝塔无法自动同步到云厂商的策略。
用 docker-compose.yml 部署多个微服务，宝塔界面里看不到容器列表
这也算是一个设计限制：宝塔的Docker管理器只识别通过其“容器管理 → 创建容器”流程创建的容器，不监控 docker-compose 启动的服务。不是Bug，但确实不方便。
- 如果坚持用 Compose，就别依赖宝塔界面查看状态——全部用终端命令：
docker-compose ps、docker-compose logs -f。 - 想在宝塔里统一管理，得把每个服务拆成独立容器，在“容器管理”里逐个创建，并手动配好网络互通（比如共用自定义 bridge 网络）。
docker-compose up -d启动的容器名会带项目前缀（如myapp_nacos_1），宝塔界面不解析这种命名规则，也不会自动归类。- 备份时注意：宝塔的“容器快照”功能对 Compose 容器无效，必须用
docker commit手动打镜像。
说到底，容器化部署微服务，真正麻烦的从来不是拉镜像或点按钮，而是每个组件对环境变量、启动参数、网络监听地址的隐式约定——这些细节不会出现在宝塔界面上，只能靠日志和命令行一层层剥开。
