Docker 方式适合已经具备容器运行环境的用户,可以快速部署 ZeroNews 客户端,并把配置文件持久化到宿主机目录中。

安装前准备

  • 已安装 Docker,并能正常拉取镜像
  • 准备好 AuthToken
  • 确认宿主机上用于持久化数据的目录,例如 /opt/zeronews
ZeroNews 官方提供两个常用镜像源:
  • 国内公共仓库:docker.zeronews.cc/zeronews/zeronews
  • Docker Hub:zeronews/zeronews
下面示例默认使用国内公共仓库。若你在海外网络环境,可以把镜像名替换为 zeronews/zeronews。

以 ZeroNews 国内公共仓库镜像启动

方式一:使用 Docker Run

先创建数据目录:
mkdir -p /opt/zeronews
然后启动容器:
docker run -d --name zeronews --net host \
	-v /opt/zeronews:/etc/zeronews \
	-e TOKEN=<YOUR_AUTH_TOKEN> \
	docker.zeronews.cc/zeronews/zeronews
这里通过环境变量 TOKEN 注入 AuthToken,因此不需要再单独执行设备认证命令。

方式二:使用 Docker Compose

先创建工作目录:
mkdir -p /opt/zeronews && cd /opt/zeronews
写入 compose 文件:
cat > docker-compose.yml << EOF
services:
	zeronews:
		restart: always
		image: docker.zeronews.cc/zeronews/zeronews
		container_name: zeronews
		hostname: zeronews
		network_mode: host
		volumes:
			- ./zeronews:/etc/zeronews
		environment:
			- TZ=Asia/Shanghai
			- TOKEN=<YOUR_AUTH_TOKEN>
EOF
启动容器:
docker compose up -d

以 Docker公共仓库镜像启动

方式一:使用 Docker Run

先创建数据目录:
mkdir -p /opt/zeronews
然后启动容器:
docker run -d --name zeronews --net host \
	-v /opt/zeronews:/etc/zeronews \
	-e TOKEN=<YOUR_AUTH_TOKEN> \
	zeronews/zeronews
这里通过环境变量 TOKEN 注入 AuthToken,因此不需要再单独执行设备认证命令。

方式二:使用 Docker Compose

先创建工作目录:
mkdir -p /opt/zeronews && cd /opt/zeronews
写入 compose 文件:
cat > docker-compose.yml << EOF
services:
	zeronews:
		restart: always
		image: zeronews/zeronews
		container_name: zeronews
		hostname: zeronews
		network_mode: host
		volumes:
			- ./zeronews:/etc/zeronews
		environment:
			- TZ=Asia/Shanghai
			- TOKEN=<YOUR_AUTH_TOKEN>
EOF
启动容器:
docker compose up -d

验证安装是否成功

检查容器是否运行:
docker ps
查看最近日志:
docker logs zeronews --tail 50
若日志中没有明显报错,且控制台可看到设备上线,说明安装基本完成。