Sub-web 终极部署指南：Docker容器化与本地开发环境完整教程

Sub-web是一个基于Vue.js和subconverter后端实现的配置自动生成工具，能够帮助用户快速生成订阅配置。作为GitHub加速计划的重要组件，sub-web部署简单且功能强大，支持多种部署方式。本文将详细介绍两种最实用的部署方法：Docker容器化部署和本地开发环境部署。🚀

📋 系统要求与准备工作

在开始部署之前，请确保您的系统满足以下基本要求：

Docker部署要求：

• Docker 23.0.4或更高版本
• 支持Linux、Windows或macOS系统

本地开发环境要求：

• Node.js 22.x版本
• Yarn 1.22.22或更高版本
• 现代Web浏览器

🐳 Docker容器化部署方法

Docker部署是最简单快捷的方式，适合生产环境使用。通过以下步骤即可完成部署：

快速启动Docker容器

使用官方镜像一键启动sub-web服务：

docker run -d -p 58080:80 --restart always --name subweb careywong/subweb:latest

自定义Docker镜像构建

如需修改代码或进行自定义配置，可以构建本地镜像：

# 克隆项目代码
git clone https://gitcode.com/gh_mirrors/su/sub-web
cd sub-web

# 构建自定义镜像
docker build -t subweb-local:latest .
docker run -d -p 58080:80 --restart always --name subweb subweb-local:latest

Docker Compose集成部署

项目提供了完整的Docker Compose配置，位于services/docker-compose.yaml，支持sub-web与MyUrls短链接服务的协同部署。

💻 本地开发环境部署

对于开发者或需要定制功能的用户，本地部署提供了更大的灵活性。

环境验证与依赖安装

首先验证Node.js和Yarn环境：

node -v
yarn -v

安装项目依赖：

yarn install

本地开发服务器启动

启动开发服务器进行测试：

yarn serve

启动后，在浏览器中访问 http://localhost:8080/ 即可使用sub-web服务。

🚀 生产环境部署指南

项目构建与打包

执行构建命令生成生产环境文件：

yarn build

构建完成后，会在项目根目录生成dist文件夹，包含所有静态资源。

Nginx服务器配置

将dist目录部署到Web服务器，以下是Nginx配置示例：

server {
    listen 80;
    server_name example.com;
    
    root /var/www/http/sub-web/dist;
    index index.html index.htm;
    
    error_page 404 /index.html;
    
    gzip on;
    gzip_min_length 1k;
    gzip_buffers 4 16k;
    gzip_http_version 1.0;
    gzip_comp_level 6;
    gzip_types text/plain text/css text/javascript application/json application/javascript application/x-javascript application/xml;
    gzip_vary on;
    
    location ~* \.(css|js|png|jpg|jpeg|gif|gz|svg|mp4|ogg|ogv|webm|htc|xml|woff)$ {
        access_log off;
        add_header Cache-Control "public,max-age=30*24*3600";
    }
}

🔧 核心配置文件说明

• 默认后端配置：src/views/Subconverter.vue 中的 defaultBackend 参数
• 环境变量配置：通过.env文件管理后端服务地址
• 组件模块：src/components/ 包含所有UI组件
• 服务层：src/services/ 处理业务逻辑

📊 部署方案对比

部署方式	适用场景	优点	缺点
Docker容器	生产环境	部署简单、环境隔离	定制性较差
本地开发	开发测试	灵活定制、调试方便	环境配置复杂

🎯 最佳实践建议

1. Docker部署：推荐用于快速部署和稳定运行
2. 本地开发：适合二次开发和功能定制
3. 混合部署：开发阶段使用本地环境，生产环境使用Docker

通过本指南，您可以根据实际需求选择合适的部署方式，快速搭建属于自己的sub-web服务。无论是简单的Docker一键部署，还是完整的本地开发环境，都能满足不同用户的使用需求。✨

无论选择哪种部署方式，sub-web都能为您提供稳定可靠的配置生成服务，助力您的GitHub加速体验！