LotDB Vue 阿里云 ECS 部署实战记录

这篇文章档 lotdb-vue 部署到阿里云 ECS 的完整流程。覆盖代码上传、Docker Compose 启动、域名解析、宿主机 Nginx 反代、HTTPS 证书接入，还有部署过程中常见问题排查。

. 推荐部署架构

当服务器已有宿主机 Nginx。而且还有其他二级域名在使用时推荐使用以下结构：

浏览器 -> https://lotdb.wkylin.cn -> 宿主机 Nginx /
-> 反代到 .:
-> Docker frontend 容器 Nginx
/ -> Vue 静态页面
/api -> backend:
/uploads -> backend:backend
-> mysql:
-> iotdb: /

公网安全组只建议开放：

• /tcpSSH
• /tcpHTTP
• /tcpHTTPS

. 服务器准备痛点

确认 Docker 和 Compose 已安装：

docker --version
docker compose version

ECS 为 2核 2G 内存 时建议开启 swap，否则项目会频繁重启。话说回来，从常见痛点来看。

• 内存不足导致 MySQL 或 IoTDB 无法正常启动。
• swap 未启用时容器会因为 OOM 被杀死。
• swap 配置错误导致程序不稳定。

sudo fallocate -l 2G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile
grep -q '^/swapfile ' /etc/fstab || echo '/swapfile swap swap defaults' | sudo tee -a /etc/fstab
free -h

. 上传代码痛点

至于建议部署目录。

mkdir -p /opt/lotdb-vue && cd /opt/lotdb-vue
git clone 
# 或者本地打包后通过 scp 上传：
scp dist/* root@ecs_ip:/opt/lotdb-vue/

User 常见痛点：

• Git 拉取失败，网络或权限问题。
• scp 文件权限错误导致容器无法读取。其实，
• 方法不一致导致 docker-compose 找不到文件。

. 配置生产环境变量痛点

复制生产环境模板并编辑：

cp backend/.env.prod.example backend/.env.prod
vim backend/.env.prod

从关键配置示例来看。

# Runtime
PORT=3000
NODE_ENV=production
JWT_SECRET=replace-with-a-long-random-secret
ADMIN_REGISTER_CODE=replace-with-your-admin-register-code
# MySQL
MYSQL_ROOT_PASSWORD=replace-with-strong-root-password
MYSQL_HOST=mysql
MYSQL_PORT=3306
MYSQL_USER=lotdb
MYSQL_PASSWORD=replace-with-strong-app-password
MYSQL_DATABASE=lotdb
# IoTDB
IOTDB_HOST=iotdb
IOTDB_PORT=20101 # TCP 接口端口
IOTDB_REST_PORT=18080 # REST 接口端口
IOTDB_USERNAME=root
IOTDB_PASSWORD=root
# Filesystem uploads folder path relative to docker volume.
UPLOAD_DIR=uploads

Pain points:

• ADMIN_REGISTER_CODE: 用于管理员注册，不是登录密码；若忘记需手动重置数据库，
• `mysql` 数据卷已初始化过后修改 MYSQL_* 参数无效；需要重新创建数据卷或手动授权使用者。
• `UPLOAD_DIR` 必须与 docker-compose 中的卷映射一致，否则上传文件无法保存。
• `JWT_SECRET` 长度不够会导致签名验证失败。
• `IOTDB_REST_PORT` 与 IOTDB 服务实际监听端口不符会导致连接拒绝。
• 默认管理员账号是 admin/Admin@?,客户账号是 buyer/Admin@?.

. Docker Compose 端口设置痛点

ECS 上已有宿主机 Nginx 时容器不要直接占用外部公开端口。推荐使用内部网络仅提供 HTTP，让宿主机负责 HTTPS。再看常见痛点，

• Nginx 双重反代冲突：- 若同时在容器和宿主机开启 HTTPS。会出现证书冲突或路由错误。至于方法，只在宿主机开启 SSL，容器仅监听内部 http。
• `docker-compose.prod.yml` 错误映射： frontend: ports的观点是。- ".::" 请确保 `.` 对应 Docker 内部服务名，如 `frontend`. 不要写成 `- ":"`。话说回来，

开启服务示例命令:

cd /opt/lotdb-vue/
docker compose -f docker-compose.prod.yml up -d --build --remove-orphans
docker compose -f docker-compose.prod.yml ps

如果 mysql 或 iotdb 状态如 “Up seconds”。但已创建数分钟说明容器在反复重启，请先看日志和内存使用。

. 域名解析痛点 

A 记录添加方式：
text
再看主机记录，lotdb
记录类型这方面，A
记录值的观点是。*.*.*.*
说到访问域名示例，text
https这方面，//lotdb.wkylin.cn
痛点的观点是，


DNS 延迟可能导致首次访问超时；可通过 TTL 调整快速切换 IP。



域名未解析到正确 IP 时HTTPS 请求会直接报证书错误；请先检查 A 记录是否生效。