安装操作

使用须知

在您使用之前, 请仔细阅读使用须知 => 使用须知

关于底包

docker 有两个镜像:

  • lswl/vertex:stable 功能包, 已 lswl/vertex-base 为底包制作

  • lswl/vertex-base 底包, 在下文的安装过程中, 可以拉取, 也可以直接跳过, 更不要使用这个镜像创建容器

设置底包是为了减少更新时所需要下载的内容, 底包 170MiB 左右, 功能包 50MiB 左右, 若下载底包, 每次更新仅需下载 50MiB 的内容, 若不下载底包, 每次更新需要下载 220MiB 的内容

关于装在哪里最好

  • 无论用在哪里, 都最推荐装在境外 VPS, 是考虑到境内网络无法稳定访问站点的情况

  • 准备用在 PT 刷流盒子上, 优先级为 境外 VPS > 盒子本身 > 本地 Nas

  • 准备用在本地 Nas 上, 如果本地 Nas 有公网 IP, 那么推荐境外 VPS, 其次选择安装在本地 Nas

  • 准备用在本地 Nas 上, 如果本地 Nas 没有公网 IP, 那么只能安装在 Nas

  • 假如本地没有 Nas, 可以安装在任何有 Docker 环境的 x86 或 arm64 的机器上, 比如 软路由, N1, j1900, j3455 设备上, 实在没办法再去考虑 Windows Docker Desktop

环境变量

有两个端口可能在 vertex 容器网络模式为 Host 时发生冲突,请按需修改。 支持以下环境变量

字段默认值备注

PORT

3000

内部 HTTP 服务端口

HTTPS_PORT

内部 HTTPS 服务端口

HTTPS_ENABLE

是否监听 HTTPS, 填写 true 则启用 HTTPS, 同时需要填写 HTTPS_PORT

REDISPORT

6379

内部 Redis 服务端口

TZ

Asia/Shanghai

时区

PUID

0

PUID

PGID

0

PGID

使用 Docker 命令安装

先拉取一次底包 (正常情况下底包不会更新, 只是拉取镜像, 不用创建容器)

docker pull lswl/vertex-base:latest

命令内的 /root/vertex 为 Vertex 的数据保存目录, 可以更换至任一有读写权限的目录。

docker run -d \
  --name vertex \
  -v /root/vertex:/vertex \
  -p 3000:3000 \
  -e TZ=Asia/Shanghai \
  --restart unless-stopped \
  lswl/vertex:stable

关于启用 HTTPS

前提条件

已经生成或下载 HTTPS 证书(cert/.crt/.cer)与私钥(key/.key)文件

如何启用

  1. 添加 HTTPS_PORT 以及 HTTPS_ENABLE 环境变量

  2. 添加 HTTPS_PORT 的端口映射

  3. 在 vertex/data 目录下创建 ssl 文件夹, 将证书文件 .crt 改名 https.crt, 将密钥文件 .key 改名 https.key 放入 ssl 文件夹

启动命令示例

docker run -d \
  --name vertex \
  -v /root/vertex:/vertex \
  -p 3000:3000 \
  -e TZ=Asia/Shanghai \
  -e HTTPS_ENABLE=true \      # 启用 https
  -e HTTPS_PORT=3443 \				# https 监听端口为 3443
  -p 3443:3443 \							# 映射 https 端口
  --restart unless-stopped \
  lswl/vertex:stable

群晖 Docker

简略版

添加文件夹映射

详细版

截图内容是旧版vertex,搭建思路可参考。 新版安装只拉取stable一个标签就可以装机了。

UNRaid Docker

UNRAID 现已支持直接在商店搜索 Vertex 下载安装!! UNRAID 现已支持直接在商店搜索 Vertex 下载安装!! UNRAID 现已支持直接在商店搜索 Vertex 下载安装!!

  1. 拉取底包

  1. 回到 unraid 的 docker 页

VPS 虚拟专用服务器

一键完成

将Vertex安装在国外的主机上,具备更好的网路环境!

SSH登录主机,root用户,粘贴一键完成命令:推荐Debian11全新纯净系统 PS:此一键完成使用的是 Docker Host网络,双栈IPV4/IPV6支持性更好。安装的是最新Vertex版本

注: 在2023年2月份出现apparmor组件的报错,更新apparmor组件安装。 个别VPS运营商原版Debian系统存在组件缺失的问题。

apt update -y && 
apt upgrade -y && 
apt install apparmor apparmor-utils -y && 
apt install curl -y && 
curl -fsSL https://get.docker.com -o get-docker.sh && 
sh get-docker.sh && 
timedatectl set-timezone Asia/Shanghai && 
mkdir -p /root/vertex && 
chmod 777 /root/vertex && 
docker run -d --name vertex --restart unless-stopped --network host -v /root/vertex:/vertex -e TZ=Asia/Shanghai lswl/vertex:stable

注: 2022年的旧命令,2023年2月份Cloudcone实测装机未报apparmor组件错误。 默认不再使用这套命令,如遇报错SSH输入 apt install apparmor apparmor-utils -y 安装一次组件。 然后SSH输入 docker restart vertex 重启容器。

apt update -y && 
apt upgrade -y && 
apt install curl -y && 
curl -fsSL https://get.docker.com -o get-docker.sh && 
sh get-docker.sh && 
timedatectl set-timezone Asia/Shanghai && 
mkdir -p /root/vertex && 
chmod 777 /root/vertex && 
docker run -d --name vertex --restart unless-stopped --network host -v /root/vertex:/vertex -e TZ=Asia/Shanghai lswl/vertex:stable

命令说明: 自动识别 主机架构 x86_64 / AMD64 / ARM64,系统环境 Debian / Ubuntu 。 && 多命令连接执行,前一条执行成功再继续执行下一条命令。 -y 询问是否,自动确认 Y 。 查找系统更新 && 安装系统更新 && 安装Curl工具 && Docker官网稳定版脚本 && 执行安装脚本sh && 修改时区 && 创建vertex文件夹 && 赋予文件夹权限 && 安装Vertex稳定版

访问Vertex

欢迎使用Vertex!

最后更新于