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

2026-02-05 05:20:32作者：毕习沙Eudora

项目地址：https://gitcode.com/gh_mirrors/su/sub-web

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";
    }
}