离线安装

在没有互联网或企业内网与互联网隔离的环境，可以离线安装。

离线安装的一般步骤是：

• 先找台能上公网的 PC，按在线安装的方法把相关的 Docker 镜像拉下来
• 然后把 Docker 镜像打包导出，复制到离线服务器上
• 在离线服务器上把 Docker 镜像导入

下面是具体的步骤，根据现场的环境可能有所不同，仅供参考。

首先找一台可以登录公网的 PC。参见前期准备和附件安装所需软件wget、docker等。

下载启动文件和声音文件。注意，下面的版本号可能会过时，在下载时请以实际的版本号为准，将里面的版本号替换为你想要的版本号，如6.6.0替换成6.7.0-pre等。

wget https://xswitch.cn/download/xswitch-community-6.7.0-pre.tar.gz --user xswitch --password password
wget https://xswitch.cn/download/music2.0.tar.gz --user xswitch --password password
wget https://xswitch.cn/download/sounds2.0.tar.gz --user xswitch --password password

dget 是一个 Docker 下载器，它允许在不运行 Docker Daemon 的情况下下载 Docker 镜像，也无需 root 权限。

先下载 dget：

wget https://gitee.com/extrame/dget/raw/master/bin/linux_amd64/dget
chmod +x dget # 设置可执行权限

如果你使用的是 ARM64 架构的系统，请下载对应的 ARM64 版本：

wget https://gitee.com/extrame/dget/raw/master/bin/linux_arm/dget
chmod +x dget # 设置可执行权限

下载 XSwitch Docker 镜像：

./dget ccr.ccs.tencentyun.com/free/xswitch-community:6.7.0-pre
./dget ccr.ccs.tencentyun.com/free/xswitch-nginx-xui:6.7.0-pre
./dget ccr.ccs.tencentyun.com/free/pgvector:0.8.2-pg18-trixie

下载完成后，可以在 tmp_free/ 找到以 .tar.gz 结尾的文件。

如果你已经安装好了 Docker，则可以使用你熟悉的docker pull命令下载所需的镜像包，如（可根据需求自行修改对应的版本号）：

docker pull ccr.ccs.tencentyun.com/free/xswitch-community:6.7.0-pre
docker pull ccr.ccs.tencentyun.com/free/xswitch-nginx-xui:6.7.0-pre
docker pull ccr.ccs.tencentyun.com/free/pgvector:0.8.2-pg18-trixie
docker pull xswitch.tencentcloudcr.com/free/dbmate:latest

使用docker save命令导出镜像并打包。

docker save -o xswitch.tar.gz ccr.ccs.tencentyun.com/free/xswitch-community:6.7.0-pre
docker save -o xui.tar.gz ccr.ccs.tencentyun.com/free/xswitch-nginx-xui:6.7.0-pre
docker save -o pg.tar.gz ccr.ccs.tencentyun.com/free/pgvector:0.8.2-pg18-trixie
docker save -o updb.tar.gz xswitch.tencentcloudcr.com/free/dbmate:latest

将下载到的内容复制到离线服务器（目标服务器）上。

将镜像复制到远程离线主机上，如：

scp *.tar.gz root@172.10.10.10:/tmp/

# 或者

scp xswitch.tar.gz root@172.10.10.10:/tmp/
scp xui.tar.gz root@172.10.10.10:/tmp/
scp pg.tar.gz root@172.10.10.10:/tmp/
scp updb.tar.gz root@172.10.10.10:/tmp/

在离线服务器上也要安装 Docker 及 Docker Compose，具体方法参见前面关于在公网上安装的说明，自行根据自己的环境选择合适的安装方法（略）。

登录到离线主机上，使用docker load命令将镜像导入系统。

ssh root@172.10.10.10
docker load -i /tmp/xswitch.tar.gz
docker load -i /tmp/xui.tar.gz
docker load -i /tmp/pg.tar.gz
docker load -i /tmp/updb.tar.gz

将下载的部署包及声音包复制到离线主机上，进行解压。

scp music2.0.tar.gz root@172.10.10.10:/tmp/
scp sounds2.0.tar.gz root@172.10.10.10:/tmp/
scp xswitch-community-6.7.0-pre.tar.gz root@172.10.10.10:/tmp/
ssh root@172.10.10.10
cd /tmp
tar zxvf xswitch-community-6.7.0-pre.tar.gz -C /usr/local/
mkdir -p /usr/local/xswitch-community-6.7.0-pre/data/{storage/{upload,blocks},log,modx,pgdata}
tar -zxvf music2.0.tar.gz -C /usr/local/xswitch-community-6.7.0-pre/data/storage/upload/
tar -zxvf sounds2.0.tar.gz -C /usr/local/xswitch-community-6.7.0-pre/data/
cd /usr/local/xswitch-community-6.7.0-pre && \
cp xtra_config.lua.example data/xtra_config.lua && cp env.example .env

修改.env，如果修改过镜像名称，请修改docker-compose.yml中对应的镜像名称，然后执行make up-nginx启动容器。

详见前面的安装步骤。

等待系统完全启动成功后，执行命令完成数据库更新。

make dbmate-up