容器部署 on 梓晨's Blog

Docker 一键部署青龙面板

Sat, 10 Oct 2026 00:00:00 +0800

青龙是支持 Python3、JavaScript、Shell 和 TypeScript 的定时任务管理平台，可以通过网页管理脚本、环境变量和任务日志。

一键部署

1
2
3
4
5
6


docker run -dit \
 -v ~/ql/data:/ql/data \
 -p 5700:5700 \
 --name qinglong \
 --restart unless-stopped \
 whyour/qinglong:latest

部署后访问 http://IP:5700/，其中 IP 替换为 Docker 宿主机地址。

参数说明

参数	作用
`-v ~/ql/data:/ql/data`	将容器数据保存在当前用户的 `~/ql/data` 目录
`-p 5700:5700`	将面板网页端口映射到宿主机
`--name qinglong`	容器名称
`--restart unless-stopped`	容器退出时自动重启，手动停止后保持停止状态
`whyour/qinglong:latest`	使用官方 `latest` 镜像

参考：青龙项目、青龙文档。

Docker 一键部署 Samba 文件共享

Sat, 10 Oct 2026 00:00:00 +0800

通过 Samba 将 Docker 宿主机的 /samba 目录共享给 Windows、macOS 等 SMB 客户端，共享名称为 www。

一键部署

1

docker run -d --name samba --restart=unless-stopped -p 139:139 -p 445:445 -v /samba:/mount dperson/samba -u "www;www" -s "www;/mount;yes;no;no;all;none"

/samba 是宿主机目录，/mount 是对应的容器目录。需要共享其他位置时，只替换挂载参数中冒号左侧的 /samba 即可；宿主机的 TCP 139 和 445 端口需可供容器使用。

连接共享

客户端	访问方式
Windows	在文件资源管理器地址栏输入 `\\IP\www`
macOS	Finder 中按 `Command + K`，输入 `smb://IP/www`

IP 替换为 Docker 宿主机地址。登录用户名为 www，密码为 www；需要其他账号或密码时，修改 -u "用户名;密码"。

共享参数说明

-s 的各字段以分号分隔，本例依次为：

字段	值	含义
共享名称	`www`	客户端访问的共享名
共享目录	`/mount`	容器内的共享路径
可浏览	`yes`	允许浏览该共享
只读	`no`	共享配置允许写入
访客访问	`no`	要求使用账号认证
允许的用户	`all`	不限定到某个用户名，允许通过认证的用户访问
管理员用户	`none`	不指定共享管理员用户

all 不会覆盖前面的访客设置，本例仍需登录。实际写入还取决于共享目录的文件系统权限；镜像提供的 -p 参数可自动设置共享目录的属主和权限，需要时加在 dperson/samba 后面，它会修改目录内文件的权限。

参考：dperson/samba 部署与参数说明。

Docker 一键部署 Runo API 客户端

Sat, 10 Oct 2026 00:00:00 +0800

Runo 是基于 Bruno 的自托管 API 客户端，通过浏览器管理和发送请求，请求由部署 Runo 的服务器执行。

一键部署

1

docker run -d --restart=unless-stopped --name runo -p 9700:9700 -e RUNO_DISABLE_AUTH=1 ghcr.io/takovibe/runo:latest

部署后访问 http://IP:9700/，其中 IP 替换为 Docker 宿主机地址。

参数说明

参数	作用
`--name runo`	容器名称
`-p 9700:9700`	将 Runo 的网页端口映射到宿主机
`RUNO_DISABLE_AUTH=1`	强制免登录模式，访问者可直接使用服务器发送 API 请求
`--restart=unless-stopped`	容器退出时自动重启，手动停止后保持停止状态

此命令没有指定持久化挂载。需要保存配置、工作区和请求集合时，可以在镜像名称前加上 -v runo-data:/data，将数据保存在 Docker 数据卷中。

参考：Runo 项目与配置说明。

Docker 部署 Hoppscotch 前端

Wed, 25 Oct 2023 00:00:00 +0000

一键安装命令

1

docker run -d --restart unless-stopped --name hoppscotch -p 8888:3000 hoppscotch/hoppscotch-frontend:latest

http://IP:8888/ 为前端访问地址。这个命令只运行前端，并不包含自托管后端、数据库和后台管理服务。完整部署请参考 Hoppscotch 自托管文档。

验证与停止

1
2


docker inspect -f '{{.State.Status}}' hoppscotch
docker logs --tail=50 hoppscotch

访问前端并测试一个可用 API 请求；跨域、认证或后端连接仍需按实际部署配置。需要临时停止前端服务时执行：

1

docker stop hoppscotch

Docker 部署 CUPS：共享 HP LaserJet 1020 打印机

Tue, 16 Aug 2022 00:00:00 +0000

前言

众所周知惠普的1020打印机是打印成本很低的一款打印机，缺点就是只支持USB链接，无法通过网络链接，更别提AirPrint了，所以我使用Docker安装CUPS服务完美解决了这一大难题。

下载镜像配置

1

git clone --depth=1 https://github.com/zihelyu/docker_cups

切换到构建目录

1

cd docker_cups/services

构建镜像

1

docker-compose up -d

访问WEB控制页面添加打印机

后台地址为 http://ip:631/admin

管理员账号为root，密码为password

点击Add Printer添加打印机并勾选Share This Printer（共享此打印机）

配置热插拔

因为使用Docker运行，打印机USB断开会导致打印机固件失效，所以需要配置热插拔检测到打印机重新插入重启容器。

1

ACTION=="add", SUBSYSTEM=="usb", ENV{DEVTYPE}=="usb_device", ENV{PRODUCT}=="3f0/2b17/100", RUN+="/usr/bin/sh -c '/usr/bin/sleep 10 && /usr/bin/docker restart cups'"

将上面的命令保存到/etc/udev/rules.d/Hp-1020-print.rules文件

Docker 部署 Aria2 RPC 下载服务

Thu, 08 Jul 2021 00:00:00 +0000

一键快速部署命令

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15


docker run -d \
 --name aria2-pro \
 --restart unless-stopped \
 --log-opt max-size=1m \
 -e PUID="$(id -u)" \
 -e PGID="$(id -g)" \
 -e UMASK_SET=022 \
 -e RPC_PORT=6800 \
 -p 6800:6800 \
 -e LISTEN_PORT=6888 \
 -p 6888:6888 \
 -p 6888:6888/udp \
 -v ~/aria2-config:/config \
 -v ~/Downloads:/downloads \
 p3terx/aria2-pro

默认RPC密钥：P3TERX

一键修改为空密钥

1

sed -i.bak 's/rpc-secret=P3TERX/#rpc-secret=P3TERX/g' ~/aria2-config/aria2.conf && docker restart aria2-pro

Docker 部署 Poste.io 邮件服务器

Sat, 03 Jul 2021 00:00:00 +0000

前言

自建邮件服务可以不受发件量限制，批量发件成本更低，但部署相对复杂，而且容易进垃圾箱。不过现在越来越多的服务商已经开发好了产品，支持一键部署等方式，极大降低了部署和使用难度。

关于Poste

Poste.io 是一款提供免费与付费版本的邮件服务软件，可以很方便的搭建：SMTP + IMAP + POP3 + 反垃圾邮件 + 防病毒 + Web 管理 + Web 电子邮件，支持以下特性。 SPF、DKIM、DMARC、SRS 的原生实现，带有简单的向导用于检测木马、病毒、恶意软件的防病毒引擎 ( ClamAV ) 内置垃圾邮件过滤器( RSPAMD ) HTTPS 上的Webmail 客户端（Roundcube）通过Sieve 脚本进行电子邮件重定向、自动回复和其他过滤（电子邮件所有者管理，每个操作都可以编写脚本）用于限制邮箱空间或电子邮件数量的配额系统管理员、域管理员、电子邮件所有者具有不同权限的Web 管理。内置Microsoft 产品的自动发现功能，Thunderbird… 帮助正确设置域和邮件服务器的诊断 SMTP - 端口 25、465 (TLS)、587 POP3 - 端口 110、995 (TLS) IMAP - 端口 143、993 (TLS) SSL TLS无处不在！没有个人数据、电子邮件、登录信息通过互联网未加密。默认情况下，所有密码都存储为加盐SHA512哈希（5000 轮）。攻击者将很难破解您的密码。整个邮件服务器容器由 Docker 与其他应用程序隔离。

准备工作

一台VPS，有独立IP 支持25端口及邮件发送建议内存1Gb以上干净的IP,没有被墙,没有被标记为垃圾IP 提前安装好Docker Docker 安装步骤见 Linux 安装 Docker Engine 与 Docker Compose。

已有 Postfix 时处理端口占用（CentOS / YUM 示例）

已有 Postfix 占用邮件端口、且准备由 Poste.io 接管邮件服务时，可以卸载 Postfix。未安装 Postfix 的环境跳过此步：

1

yum -y autoremove postfix

一键快速部署命令

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11


docker run -d \
 -p 8888:8888 -p 25:25 -p 110:110 -p 143:143 -p 465:465 -p 587:587 -p 993:993 -p 995:995 -p 4190:4190 \
 -e "HTTPS_PORT=8888" \
 -e TZ=Asia/Shanghai \
 -e "DISABLE_CLAMAV=TRUE" \
 -e "DISABLE_RSPAMD=TRUE" \
 -v ~/mail-data:/data \
 --name "mailserver" \
 -h "mail.yourdomain.com" \
 --restart unless-stopped \
 -t analogic/poste.io

部署后访问 https://IP:8888/，根据提示完成初始化设置。本例通过 DISABLE_CLAMAV 和 DISABLE_RSPAMD 关闭病毒扫描与垃圾邮件过滤，以减少资源占用。

参数对应上面的部署命令：

参数	作用
`-p 8888:8888`、`HTTPS_PORT=8888`	将 HTTPS 管理页面设为 8888 端口并映射到宿主机
`DISABLE_CLAMAV=TRUE`	禁用 ClamAV 病毒扫描
`DISABLE_RSPAMD=TRUE`	禁用 Rspamd 垃圾邮件过滤
`TZ=Asia/Shanghai`	使用上海时区
`-v ~/mail-data:/data`	将邮件数据持久化到宿主机 `~/mail-data`
`-h mail.yourdomain.com`	邮件服务器域名，替换为自己的域名
`--restart unless-stopped`	容器退出时自动重启，手动停止后保持停止状态

修复某些页面HTTPS端口变443问题

 1
 2
 3
 4
 5
 6
 7
 8
 9
10


docker exec mailserver sh -lc '
cp -n /etc/nginx/fastcgi_params /etc/nginx/fastcgi_params.bak

sed -i "s|HTTP_HOST \\\$host;|HTTP_HOST \\\$host:\\\$server_port;|" \
 /etc/nginx/fastcgi_params

grep -n "HTTP_HOST" /etc/nginx/fastcgi_params

nginx -t && nginx -s reload
'

参考：Poste.io 部署参数。

ARM64 Linux 一键安装 Docker Compose 独立版

Thu, 06 May 2021 00:00:00 +0000

前言

这是自行编译的 Docker Compose 1.27.4 ARM64 独立版安装记录，复制下面的命令即可安装。

1

mkdir -p /usr/local/bin && curl -fsSL -o /usr/local/bin/docker-compose https://github.com/dawn2000/docker-compose/raw/master/docker-compose-Linux-aarch64 && chmod +x /usr/local/bin/docker-compose

验证安装

1

docker-compose version

如果有输出版本号就说明安装成功了

Linux 安装 Docker Engine 与 Docker Compose

Fri, 05 Mar 2021 00:00:00 +0000

适用范围

以下分别提供 RPM 与 Debian/Ubuntu 的安装步骤，按自己的系统选择一组执行。

1

cat /etc/os-release

已有 Docker 实例时，先检查官方文档列出的冲突包与已有源文件。不要删除数据目录；已存在的 docker.list 或其他 Docker 源条目需要核对，避免与新建的 docker.sources 重复。

RPM 系统：CentOS Stream

以下用于 Docker 当前支持的 CentOS Stream 9/10：

1
2
3
4


sudo dnf install -y curl \
&& sudo curl -fsSL https://download.docker.com/linux/centos/docker-ce.repo -o /etc/yum.repos.d/docker-ce.repo \
&& sudo dnf install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin \
&& sudo systemctl enable --now docker

RPM 系统：RHEL

RHEL 使用对应的 RHEL 软件源，不混用 CentOS 源。以下按官方支持的 RHEL 8/9/10 安装：

1
2
3
4


sudo dnf install -y curl \
&& sudo curl -fsSL https://download.docker.com/linux/rhel/docker-ce.repo -o /etc/yum.repos.d/docker-ce.repo \
&& sudo dnf install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin \
&& sudo systemctl enable --now docker

Rocky Linux 等兼容发行版需按自己的版本核对对应仓库。

Debian 软件源

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14


sudo apt-get update
sudo apt-get install -y ca-certificates curl
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/debian/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc

sudo tee /etc/apt/sources.list.d/docker.sources <<EOF
Types: deb
URIs: https://download.docker.com/linux/debian
Suites: $(. /etc/os-release && echo "$VERSION_CODENAME")
Components: stable
Architectures: $(dpkg --print-architecture)
Signed-By: /etc/apt/keyrings/docker.asc
EOF

Ubuntu 软件源

Ubuntu 用户执行这一组，不要同时添加 Debian 源：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14


sudo apt-get update
sudo apt-get install -y ca-certificates curl
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc

sudo tee /etc/apt/sources.list.d/docker.sources <<EOF
Types: deb
URIs: https://download.docker.com/linux/ubuntu
Suites: $(. /etc/os-release && echo "${UBUNTU_CODENAME:-$VERSION_CODENAME}")
Components: stable
Architectures: $(dpkg --print-architecture)
Signed-By: /etc/apt/keyrings/docker.asc
EOF

可选：软件包下载使用清华源

软件包下载源与 Docker Hub 镜像加速是两件事。完成所属系统的软件源配置后，需要国内软件包源时执行对应命令。

RPM 系统：

1

sudo sed -i 's|https://download.docker.com|https://mirrors.tuna.tsinghua.edu.cn/docker-ce|g' /etc/yum.repos.d/docker-ce.repo

Debian/Ubuntu：

1

sudo sed -i 's|https://download.docker.com|https://mirrors.tuna.tsinghua.edu.cn/docker-ce|g' /etc/apt/sources.list.d/docker.sources

RPM 已安装时，替换源用于后续更新；也可以在上面下载 .repo 后、安装软件包前执行替换命令。

Debian/Ubuntu 安装与启动

完成所属系统的软件源配置后执行：

1
2
3


sudo apt-get update \
&& sudo apt-get install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin \
&& sudo systemctl enable --now docker

验证安装

1
2


sudo docker run --rm hello-world
docker compose version

可选：配置 Docker Hub 镜像加速

下面使用 USTC 文档中的地址作为示例，使用前按镜像站说明确认适用于自己的网络；有其他可用镜像时替换地址即可。

使用 Python 3 自动合并 registry-mirrors 字段，保留已有的其他 Docker 配置：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10


sudo python3 - <<'PY'
import json
from pathlib import Path

path = Path('/etc/docker/daemon.json')
config = json.loads(path.read_text()) if path.exists() else {}
config['registry-mirrors'] = ['https://docker.mirrors.ustc.edu.cn']
path.parent.mkdir(parents=True, exist_ok=True)
path.write_text(json.dumps(config, indent=2) + '\n')
PY

配置完成后重启并查看结果：

1
2


sudo systemctl restart docker
sudo docker info

可选：一键安装 Compose 独立版

需要保留 docker-compose 命令时，可自动下载最新独立版，无需手工填写版本：

1
2
3


sudo curl -fL "https://github.com/docker/compose/releases/latest/download/docker-compose-linux-$(uname -m)" -o /usr/local/bin/docker-compose \
&& sudo chmod +x /usr/local/bin/docker-compose \
&& docker-compose version

上面的 Compose 插件使用 docker compose，独立版使用 docker-compose，按自己的调用方式选择。

Compose V1：旧环境安装记录

以下命令安装固定版本 Compose 1.29.2，适用于需要该旧版本的 x86_64 环境。Compose V1 已结束维护，新安装使用上面的方式；两种独立版安装方法二选一，都写入 /usr/local/bin/docker-compose：

1
2


sudo curl -fL -o /usr/local/bin/docker-compose https://github.com/docker/compose/releases/download/1.29.2/docker-compose-Linux-x86_64 \
&& sudo chmod +x /usr/local/bin/docker-compose

参考：CentOS 官方步骤、RHEL 官方步骤、Debian 官方步骤、Ubuntu 官方步骤、清华 Docker CE 源、Compose 独立版。

容器部署 on 梓晨's Blog

Docker 一键部署青龙面板

一键部署

参数说明

延伸阅读

Docker 一键部署 Samba 文件共享

一键部署

连接共享

共享参数说明

延伸阅读

Docker 一键部署 Runo API 客户端

一键部署

参数说明

延伸阅读

Docker 部署 Hoppscotch 前端

一键安装命令

验证与停止

延伸阅读

Docker 部署 CUPS：共享 HP LaserJet 1020 打印机

前言

下载镜像配置

切换到构建目录

构建镜像

访问WEB控制页面添加打印机

配置热插拔

延伸阅读

Docker 部署 Aria2 RPC 下载服务

一键快速部署命令

一键修改为空密钥

延伸阅读

Docker 部署 Poste.io 邮件服务器

前言

关于Poste

准备工作

已有 Postfix 时处理端口占用（CentOS / YUM 示例）

一键快速部署命令

修复某些页面HTTPS端口变443问题

ARM64 Linux 一键安装 Docker Compose 独立版

前言

验证安装

Linux 安装 Docker Engine 与 Docker Compose

适用范围

RPM 系统：CentOS Stream

RPM 系统：RHEL

Debian 软件源

Ubuntu 软件源

可选：软件包下载使用清华源

Debian/Ubuntu 安装与启动

验证安装

可选：配置 Docker Hub 镜像加速

可选：一键安装 Compose 独立版

Compose V1：旧环境安装记录

延伸阅读