Zoraxy项目Docker容器化部署指南

项目概述

Zoraxy是一款功能强大的反向代理和负载均衡工具，本文主要介绍如何使用Docker容器化方式部署Zoraxy服务。通过Docker部署可以简化安装过程，提高环境一致性，并便于后续维护升级。

部署前准备

在开始部署前，请确保您已完成以下准备工作：

1. 已安装Docker环境（包括Docker Engine和Docker Compose）
2. 了解基本的Docker操作命令
3. 如需从外部网络访问服务，请确保已正确配置路由器端口转发（80和443端口）

部署方式选择

Zoraxy提供两种Docker部署方式，您可以根据实际需求选择：

1. 使用docker run命令部署

docker run -d \
  --name zoraxy \
  --restart unless-stopped \
  --add-host=host.docker.internal:host-gateway \
  -p 80:80 \
  -p 443:443 \
  -p 8000:8000 \
  -v /path/to/zoraxy/config/:/opt/zoraxy/config/ \
  -v /path/to/zoraxy/plugin/:/opt/zoraxy/plugin/ \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -v /etc/localtime:/etc/localtime \
  -e FASTGEOIP="true" \
  zoraxydocker/zoraxy:latest

2. 使用docker-compose.yml文件部署

services:
  zoraxy:
    image: zoraxydocker/zoraxy:latest
    container_name: zoraxy
    restart: unless-stopped
    ports:
      - 80:80
      - 443:443
      - 8000:8000
    volumes:
      - /path/to/zoraxy/config/:/opt/zoraxy/config/
      - /path/to/zoraxy/plugin/:/opt/zoraxy/plugin/
      - /var/run/docker.sock:/var/run/docker.sock
      - /etc/localtime:/etc/localtime
    extra_hosts:
      - "host.docker.internal:host-gateway"
    environment:
      FASTGEOIP: "true"

关键配置说明

端口映射

端口号	用途说明
80	HTTP流量入口
443	HTTPS流量入口
8000	管理界面端口（可通过环境变量PORT修改）

数据卷挂载

容器路径	主机路径	用途说明
/opt/zoraxy/config/	/path/to/zoraxy/config/	存储Zoraxy配置文件
/opt/zoraxy/plugin/	/path/to/zoraxy/plugin/	存储Zoraxy插件
/var/run/docker.sock	/var/run/docker.sock	用于Docker功能集成
/etc/localtime	/etc/localtime	保持容器与主机时间同步

重要环境变量

Zoraxy支持多种环境变量配置，以下是常用选项：

变量名	默认值	说明
FASTGEOIP	false	启用高速GeoIP查询（需要额外1GB内存）
PORT	8000	管理界面监听端口
DOCKER	true	Docker兼容模式
WEBFM	true	启用静态网站文件管理器
NOAUTH	false	禁用管理界面身份验证（不建议生产环境使用）

高级配置

ZeroTier集成

如需使用ZeroTier功能，需要在部署时添加以下配置：

对于docker run命令：

--cap_add NET_ADMIN --device /dev/net/tun:/dev/net/tun

对于docker-compose.yml：

cap_add:
  - NET_ADMIN
devices:
  - /dev/net/tun:/dev/net/tun

插件管理

Zoraxy提供实验性的插件商店功能，可直接从管理界面下载官方插件。如需使用自定义插件，请将插件文件放置在/opt/zoraxy/plugin/目录下。

访问管理界面

部署完成后，可通过以下地址访问Zoraxy管理界面：

http://<主机IP>:8000

注意事项

1. 生产环境不建议禁用身份验证(NOAUTH=false)
2. 高速GeoIP功能(FASTGEOIP)会显著增加内存使用量
3. 端口转发配置时，Docker环境变量值不应包含冒号（如PORT="8000"）
4. 建议使用命名卷或指定主机路径存储配置数据，避免数据丢失

通过以上步骤，您应该已经成功部署了Zoraxy服务。如需进一步定制，可以参考官方文档调整各项参数。