1Panel快速轻量应用项目启动最佳实践

现在写代码用 AI 已经很快了，但自动化运维、项目部署却难倒一片，本文教你快速部署前后端并包含反向代理，快速部署，可批量复制应用。

一、技术栈介绍

在本最佳实践中，我们采用 1Panel + Docker Compose + Cursor 的技术组合来实现快速且可靠的应用部署。

1.1 核心组件说明

• 1Panel：开源的现代化服务器运维管理面板，提供可视化的容器管理和应用部署能力
• Docker Compose：容器编排工具，用于定义和运行多容器应用
• Cursor：智能代码编辑器，支持 AI 辅助开发，提高编码效率

二、项目结构设计

推荐使用以下标准化的项目结构：

项目根目录/
├── docker-compose.yml          # Docker Compose 主配置文件
├── nginx.conf                  # Nginx 配置文件
├── frontend/
│   ├── Dockerfile             # 前端 Docker 构建文件
│   └── .env                   # 前端环境变量配置
└── backend/
    └── Dockerfile             # 后端 Docker 构建文件

2.1 Docker Compose 配置示例

version: '3.8'

services:
  nginx:
    image: nginx:alpine
    ports:
      - "18080:80"
    volumes:
      - ./nginx.conf:/etc/nginx/conf.d/default.conf
    depends_on:
      - frontend
      - backend

  frontend:
    build:
      context: ./frontend
      dockerfile: Dockerfile
    expose:
      - "3000"

  backend:
    build:
      context: ./backend
      dockerfile: Dockerfile
    expose:
      - "8000"
    volumes:
      - ./backend/apikey.txt:/app/apikey.txt:ro

三、环境配置最佳实践

3.1 Docker 镜像源配置

• 推荐使用 1Panel 内置的 Docker 镜像源，可以显著提升镜像拉取速度
• 无需额外配置，避免复杂的镜像源设置问题

四、项目部署流程

4.1 首次部署

1. 进入项目目录并拉取最新代码：

cd 项目目录 && git pull

2. 在 1Panel 面板中：
   • 进入"容器 - 编排"
   • 点击"创建编排"
   • 选择"手动选择"
   • 选择项目目录下的 docker-compose.yml
   • 确认创建

4.2 代码更新部署

1. 更新代码：

cd 项目目录 && git pull

2. 清理旧容器和镜像：
   • 在 1Panel 的"容器 - 容器"中删除前后端容器
   • 在"容器 - 镜像"中删除对应镜像
3. 重新部署：
   • 进入"容器 - 编排"
   • 选择已有编排并点击编辑
   • 确认重新部署

五、注意事项

• 删除容器后必须同时删除关联镜像
• 更新代码后必须重建镜像才能生效
• 确保 nginx.conf 配置正确以保证前后端通信

六、常见问题排查

• 如遇构建失败，检查 Dockerfile 配置
• 端口冲突时，修改 docker-compose.yml 中的端口映射
• 确保各服务之间的依赖关系正确配置