Linux容器部署常见四大误区：一是未挂载宿主机目录导致文件不可见，需用-v显式映射并注意权限；二是忽略日志和inspect排查启动失败；三是未同步时区，应挂载/etc/localtime并设TZ环境变量；四是误将容器当虚拟机长期运行，应清理无用容器镜像、避免exec手动改配置、关键数据必须挂载或用volume。

Linux容器环境部署不难，但新手常因几个关键点理解偏差，反复卡在启动失败、文件读不到、时间错乱或权限报错上。核心不是命令记不全，而是对“容器与宿主机的关系”没建立准确认知。

误区一：以为容器能直接读宿主机任意目录

容器默认运行在隔离的文件系统里，不挂载就看不到宿主机文件。常见错误是把配置文件放本地，却没用 -v 映射进去。

• 正确做法：启动时显式挂载，例如 docker run -v /host/conf:/app/conf nginx，让容器内 /app/conf 实际指向宿主机 /host/conf
• 注意路径权限：宿主机目录需对容器用户（如非 root）可读，否则应用启动时报“permission denied”
• 临时调试可用 docker cp 复制文件进出容器，但不能替代挂载——重启后修改会丢失

误区二：容器起不来就急着改代码或重做镜像

多数启动失败和代码无关，先看日志再动手。

java-api-doc-generator

分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。

下载

• 用 docker logs 查输出，90% 的问题（如端口被占、配置路径错、依赖缺失）都在这里暴露
• 如果容器秒退，加 --rm 启动后立即退出，用 docker ps -a 找到 ExitCode，再查日志
• 别跳过 docker inspect ，它能告诉你实际绑定的端口、挂载路径、环境变量是否符合预期

误区三：忽略时区和时间同步问题

容器默认用 UTC，但业务日志、定时任务、前端展示都指望本地时间——不处理就会“时间对不上”。

• 最稳妥方式：启动时挂载宿主机时区文件，docker run -v /etc/localtime:/etc/localtime:ro ...
• 补充设置环境变量：-e TZ=Asia/Shanghai，尤其对 Java、Node.js 等依赖 TZ 的运行时更有效
• 验证方法：进容器执行 date，再看 ls -l /etc/localtime 是否链接到正确的时区文件

误区四：把容器当虚拟机用，长期不清理

容器不是要一直开着的“小系统”，设计上强调轻量、短暂、可替换。

• 不用的停止容器及时删：docker rm ；镜像定期清理：docker image prune
• 避免用 docker exec -it 进去手动改配置——下次重建容器就丢了；所有配置应通过挂载、环境变量或构建时 COPY 进镜像
• 数据目录（如数据库、日志）务必挂载到宿主机或使用 volume，否则容器删掉，数据全丢

基本上就这些。不复杂但容易忽略，关键是每次操作前问一句：“这个动作，是在容器里？还是宿主机上？它们之间怎么连通？”想清楚这层，大部分坑就绕过去了。