请求指导：在AWS Lightsail上部署Twenty CRM

一、前置准备 #

• 已注册AWS账号并开通Lightsail服务
• 本地具备SSH访问工具（Windows可使用PowerShell/PuTTY，macOS/Linux系统自带）
• 掌握基础Linux命令操作

二、创建Lightsail实例 #

1. 登录AWS Lightsail控制台，点击创建实例
2. 选择实例部署区域（优先选靠近目标用户的区域，如ap-southeast-1或us-east-1）
3. 平台选择Linux/Unix，镜像指定为Ubuntu 22.04 LTS（Twenty官方推荐的兼容环境）
4. 实例规格：至少选择2GB内存/2vCPU的套餐（低配实例可能导致运行卡顿）
5. SSH密钥配置：可使用Lightsail自动生成的密钥，或上传本地SSH公钥以简化后续登录
6. 设置实例名称后点击创建，等待实例启动完成

三、初始化实例环境 #

• 通过Lightsail控制台的连接按钮，或本地SSH命令登录实例：

  ssh -i /本地密钥路径/your-key.pem ubuntu@[实例公网IP]
  

• 更新系统软件包：

  sudo apt update && sudo apt upgrade -y
  

• 安装Docker与Docker Compose（Twenty官方推荐容器化部署）：

  # 安装Docker
  sudo apt install docker.io -y
  sudo systemctl enable --now docker
  sudo usermod -aG docker ubuntu
  
  # 安装Docker Compose
  sudo apt install docker-compose -y
  

• 退出当前会话后重新登录，使Docker权限生效

四、部署Twenty CRM #

• 克隆Twenty项目仓库到实例：

  git clone https://github.com/twentyhq/twenty.git
  cd twenty
  

• 复制并配置环境变量文件：

  cp .env.example .env
  

  编辑.env文件，重点修改以下核心参数：
  • APP_URL：设置为实例公网IP或绑定的域名（例如http://你的公网IP:3000）
  • DATABASE_URL：保持默认值即可（容器会自动创建并配置PostgreSQL数据库）
  • 可根据需求修改邮件服务、Redis等其他配置项
• 启动所有服务容器：

  docker-compose up -d
  

• 验证容器运行状态：

  docker-compose ps
  

  确认所有服务容器状态均为Up

五、访问与后续配置 #

• 在浏览器中访问http://[实例公网IP]:3000，若出现Twenty的注册页面则部署成功
• 注册首个管理员账号，开始自定义CRM配置
• （可选）域名与HTTPS配置：
  1. 在Lightsail控制台将域名绑定至实例
  2. 安装Nginx作为反向代理，使用Let's Encrypt的Certbot工具配置SSL证书

六、常见故障排查 #

• 容器启动失败时，查看对应服务日志：

  docker-compose logs [服务名称，如backend/frontend]
  

• 检查Lightsail实例防火墙：默认仅开放22端口，需手动添加3000端口的TCP访问规则（在实例网络标签中配置）
• 若无法访问页面，确认实例公网IP正确、防火墙规则生效，且容器服务正常运行

内容的提问来源于stack exchange，提问作者Muzzamil Shaikh