使用Docker Compose部署Morphic项目的完整指南

Morphic是一个基于Bun运行时环境的现代Web应用项目。本文将详细介绍如何通过Docker Compose快速部署Morphic项目到本地开发环境或生产服务器。

基础Docker Compose配置

对于大多数开发者来说，一个基本的Docker Compose配置就足够启动Morphic项目。以下是经过验证的标准配置：

version: "3.7"
services:
  morphic:
    build:
      context: .
      dockerfile: Dockerfile
    command: bun dev
    env_file: .env
    ports:
      - "3008:3000"

这个配置做了以下几件事：

1. 使用当前目录下的Dockerfile构建镜像
2. 运行bun dev命令启动开发服务器
3. 从.env文件加载环境变量
4. 将容器内的3000端口映射到主机的3008端口

网络访问配置

如果需要让Morphic服务能被局域网内其他设备访问，需要修改启动命令：

command: bun dev -H 0.0.0.0

这个修改让服务监听所有网络接口，而不仅仅是本地回环地址。

环境配置建议

在实际部署中，建议使用.env.local文件来管理环境变量，这样可以避免将敏感信息提交到版本控制系统：

env_file: .env.local

端口映射策略

端口映射可以根据实际需求灵活调整。标准配置将容器端口3000映射到主机3008端口，这是为了避免与主机上可能运行的其他服务冲突。如果3008端口已被占用，可以修改为其他可用端口：

ports:
  - "8080:3000"  # 主机端口:容器端口

生产环境建议

对于生产环境部署，建议考虑以下增强配置：

1. 使用明确的镜像标签而非每次构建
2. 配置资源限制(CPU/内存)
3. 设置健康检查
4. 配置日志驱动
5. 考虑添加数据库等服务依赖

常见问题解决

如果在部署过程中遇到连接问题，可以检查以下几点：

1. 确保Docker服务正常运行
2. 验证端口是否被防火墙阻止
3. 检查.env文件配置是否正确
4. 查看容器日志定位具体错误原因

通过以上配置和说明，开发者可以快速在本地或服务器上部署Morphic项目，并根据实际需求进行定制化调整。Docker Compose提供了便捷的方式来管理服务依赖和配置，大大简化了部署流程。