Docker 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 部署 Zigbee2MQTT

Wed, 29 Mar 2023 00:00:00 +0000

安装命令

使用 Docker 部署，重启策略为 unless-stopped：

1
2
3
4
5
6
7


docker run -d \
 --name zigbee2mqtt \
 --restart unless-stopped \
 -p 8080:8080 \
 -e TZ=Asia/Shanghai \
 -v ~/zigbee2mqtt/data:/app/data \
 koenkk/zigbee2mqtt:latest

后台地址为 http://IP:8080/。配置文件位于 ~/zigbee2mqtt/data/configuration.yaml；MQTT 和网络协调器地址按自己的实际地址填写。

2.x 及后续版本配置

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


mqtt:
 base_topic: zigbee2mqtt
 server: mqtt://192.168.1.10:1883
 user: admin
 password: public
serial:
 port: tcp://192.168.1.20:8888
 adapter: zstack
advanced:
 channel: 15
frontend:
 enabled: true
 port: 8080
homeassistant:
 enabled: true

192.168.1.10:1883 是 MQTT 服务地址，192.168.1.20:8888 是网络协调器地址，均需替换为实际地址。账号和密码使用自己的 MQTT 凭据；adapter: zstack 对应 TI Z-Stack 协调器，其他类型使用对应的 adapter。

通过命令开启配对

2.0 起移除了配置文件中的 permit_join 和永久允许加入功能。可通过 MQTT 命令开启配对，无需手工点页面。安装了 mosquitto_pub 的机器上执行：

1
2


mosquitto_pub -h 192.168.1.10 -p 1883 -u admin -P public \
 -t zigbee2mqtt/bridge/request/permit_join -m '{"time":254}'

将地址和凭据替换为配置中的实际值；新版单次配对窗口最多 254 秒，时间到了可再次执行。也可在前端开启配对。

1.x 配置格式

使用 1.x 镜像的环境采用下面的格式。上面的 latest 部署使用新版格式，两组配置按镜像版本选择，不要合并：

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


homeassistant: true
permit_join: true
mqtt:
 base_topic: zigbee2mqtt
 server: mqtt://192.168.1.10:1883
 user: admin
 password: public
serial:
 port: tcp://192.168.1.20:8888
advanced:
 channel: 15
frontend: true

USB 协调器

使用 USB 时，将 serial.port 改成容器内设备路径，例如 /dev/ttyUSB0，并在创建容器时加入实际设备映射：

1
2


--device=/dev/serial/by-id/实际设备ID:/dev/ttyUSB0
-v /run/udev:/run/udev:ro

参考：Docker 部署、2.0 配置迁移、MQTT 配对命令。

Docker 部署 Home Assistant Container

Wed, 29 Mar 2023 00:00:00 +0000

安装命令

1
2
3
4
5
6
7


docker run -d \
 --name homeassistant \
 --restart unless-stopped \
 -e TZ=Asia/Shanghai \
 -v ~/homeassistant/config:/config \
 --network=host \
 ghcr.io/home-assistant/home-assistant:stable

管理页面为 http://IP:8123/。此示例适用于 Linux 宿主机的 host 网络；Home Assistant Container 不包含 Supervisor 和附加组件商店。

验证运行状态

1
2


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

容器状态应为 running，然后访问管理页面完成初始化。若反复重启，先检查日志和配置目录权限。

备份与恢复

升级前备份 ~/homeassistant/config，并记录原镜像版本。升级回退需要按 Home Assistant 对应版本的要求恢复备份及镜像，避免仅切换标签后复用不兼容的数据。

临时停止容器

停止服务时执行，配置目录会保留：

1

docker stop homeassistant

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 使用 macvlan 部署 OpenWrt 旁路由

Tue, 20 Jul 2021 00:00:00 +0000

本文在 Linux 宿主机上使用 macvlan 运行 OpenWrt 旁路由，地址规划如下。执行前按实际网络替换地址和物理网卡名 eth0。

设备	IPv4 地址	网关与 DNS
上游路由器	`10.0.0.254`	按现有上游网络配置
OpenWrt 旁路由	`10.0.0.1`	`10.0.0.254`
宿主机 macvlan 接口	`10.0.0.11`	`10.0.0.1`

Docker 网络的网关填写上游路由器地址 10.0.0.254，OpenWrt 容器使用 10.0.0.1，两者占用不同地址。

IPv6 部分使用静态地址：容器为 fd00:10::1/64，上游网关示例为 fd00:10::fe。这组 ULA 地址用于本地网络，上游路由器也需要配置对应网关地址；复制示例不会获得公网 IPv6。使用公网 IPv6 时，Docker 子网、容器地址与 OpenWrt 内部地址、网关均需改成实际网络提供的对应值。

配置系统环境

打开网卡混杂模式

1

ip link set eth0 promisc on

加载 PPPOE 内核模块

1

modprobe pppoe

创建接口

1
2
3
4
5


docker network create -d macvlan \
 --subnet=10.0.0.0/24 --gateway=10.0.0.254 \
 --ipv6 --subnet=fd00:10::/64 --gateway=fd00:10::fe \
 -o parent=eth0 \
 macvlan

创建容器

下载OpenWrt镜像

1

docker pull dawn2000/openwrt:latest

创建并启动容器

 1
 2
 3
 4
 5
 6
 7
 8
 9
10


docker run -d \
 --restart unless-stopped \
 --net macvlan \
 --ip 10.0.0.1 \
 --ip6 fd00:10::1 \
 --cap-add NET_ADMIN \
 --hostname OpenWrt \
 --name openwrt \
 dawn2000/openwrt:latest \
 sh -c "echo -e 'search lan\nnameserver 127.0.0.1\nnameserver ::1' > /etc/resolv.conf && /sbin/init"

配置 OpenWrt

进入容器终端

1

docker exec -it openwrt /bin/sh

使用vi编辑 /etc/config/network

 1
 2
 3
 4
 5
 6
 7
 8
 9
10


config interface 'lan'
 option type 'bridge'
 option ifname 'eth0'
 option proto 'static'
 option ipaddr '10.0.0.1' #旁路由地址
 option netmask '255.255.255.0'
 option gateway '10.0.0.254' #上游路由地址
 option dns '10.0.0.254'
 option ip6addr 'fd00:10::1/64'
 option ip6gw 'fd00:10::fe'

Docker 的 --ip、--ip6 分别与这里的 ipaddr、ip6addr 保持一致。ip6addr 设置容器的静态 IPv6 地址，ip6gw 设置上游网关；这里不配置自动前缀分配。

重启 openwrt 网络

1

/etc/init.d/network restart

宿主机通信：ifupdown 配置示例

由于 docker 网络采用 macvlan 的 bridge 模式，即使宿主机与容器在同一网段，相互之间也是无法通信的。为了解决这个问题，需利用多个 macvlan 接口之间是互通的原理，在 LAN 口新建一个 macvlan 虚拟接口。

以下持久化配置仅适用于使用 ifupdown 与 /etc/network/interfaces 的宿主机，常见于部分 Debian 环境。macvlan 的原理不依赖 Debian；使用 Netplan、NetworkManager 或 systemd-networkd 时，需要在实际网络管理工具中创建对应接口，不要直接套用这个文件。

编辑 /etc/network/interfaces，按实际地址规划添加配置。示例 IP 只分配给 macvlan，不能同时重复分配给物理接口：

1
2
3
4
5
6
7
8


auto macvlan
iface macvlan inet static
 address 10.0.0.11 #此处为宿主机ip
 netmask 255.255.255.0
 gateway 10.0.0.1
 dns-nameservers 10.0.0.1
 pre-up ip link add macvlan link eth0 type macvlan mode bridge
 post-down ip link del macvlan link eth0 type macvlan mode bridge

参考：Docker macvlan 的 IPv6 配置、OpenWrt IPv6 配置。

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 部署参数。

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 独立版。

Docker 编译 ImmortalWrt（Ubuntu 24.04 容器示例）

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

本文使用 Ubuntu 24.04 容器作为编译环境。ImmortalWrt 分支、依赖包和第三方 Feed 的文件路径会随版本变化，安装依赖与修改文件时需与目标分支对应。

宿主机与容器环境

编译环境中的 APT 源、包名与定制步骤以 Ubuntu 24.04 容器为例，不代表宿主机必须安装 Ubuntu。宿主机需要能运行该容器的 Docker 环境；宿主机架构、容器架构与目标固件架构还需分别确认。

换用其他容器基础镜像时，应调整编译依赖与构建环境，不能只修改镜像名字。

下载镜像

1

docker pull ubuntu:24.04

启动容器

1

docker run --name ubuntu -itd ubuntu:24.04 /bin/bash

进入容器

1

docker exec -it ubuntu /bin/bash

更换为国内apt源

 1
 2
 3
 4
 5
 6
 7
 8
 9
10


# Ubuntu 24.04 官方镜像通常使用 deb822 格式；ARM64 镜像使用 ports 源。
if [ -f /etc/apt/sources.list.d/ubuntu.sources ]; then
 sed -i \
 -e 's|http://archive.ubuntu.com/ubuntu|https://mirrors.tuna.tsinghua.edu.cn/ubuntu|g' \
 -e 's|http://security.ubuntu.com/ubuntu|https://mirrors.tuna.tsinghua.edu.cn/ubuntu|g' \
 -e 's|http://ports.ubuntu.com/ubuntu-ports|https://mirrors.tuna.tsinghua.edu.cn/ubuntu-ports|g' \
 /etc/apt/sources.list.d/ubuntu.sources
else
 echo '未找到 ubuntu.sources，请先检查当前 APT 源文件位置。'
fi

更新apt列表

1

apt-get update

安装必要扩展

1
2
3
4
5
6
7


DEBIAN_FRONTEND=noninteractive apt-get install -y ack antlr3 asciidoc autoconf automake autopoint binutils bison build-essential \
bzip2 ccache cmake cpio curl device-tree-compiler fastjar flex gawk gettext gcc-multilib g++-multilib \
git gperf haveged help2man intltool libc6-dev-i386 libelf-dev libfuse-dev libglib2.0-dev libgmp3-dev \
libltdl-dev libmpc-dev libmpfr-dev libncurses5-dev libncursesw5-dev libpython3-dev libreadline-dev \
libssl-dev libtool lrzsz mkisofs msmtp ninja-build p7zip p7zip-full patch pkgconf python3 \
python3-pyelftools python3-setuptools qemu-utils rsync scons squashfs-tools subversion swig texinfo \
uglifyjs upx-ucl unzip vim wget xmlto xxd zlib1g-dev

下载openwrt源码

1
2
3


cd \
&& git clone https://github.com/immortalwrt/immortalwrt --depth=1 \
&& cd immortalwrt

添加helloworld支持库

1

sed -i '1i src-git helloworld https://github.com/zihelyu/helloworld.git' feeds.conf.default

添加passwall支持库(二选一即可)

1
2


sed -i '1i src-git passwall_packages https://github.com/Openwrt-Passwall/openwrt-passwall-packages.git;main\
src-git passwall_luci https://github.com/Openwrt-Passwall/openwrt-passwall2;main' feeds.conf.default

下载及更新软件包

1

./scripts/feeds update -a && ./scripts/feeds install -a

删除DDNS默认示例配置

1

sed -i '/myddns_ipv4/,$d' ./feeds/packages/net/ddns-scripts/files/etc/config/ddns

修改passwall默认代理全部TCP端口

1

#sed -i "s/tcp_redir_ports '22,25,53,143,465,587,853,993,995,80,443'/tcp_redir_ports '1:65535'/g" ./feeds/passwall_luci/luci-app-passwall2/root/usr/share/passwall2/0_default_config

修改passwall默认分流策略

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


CFG="./feeds/passwall_luci/luci-app-passwall2/root/usr/share/passwall2/0_default_config"; \
grep -q "config shunt_rules 'AppleBlack'" "$CFG" || sed -i "/^config shunt_rules 'CN'/i\\
config shunt_rules 'AppleBlack'\\
 option remarks 'AppleBlack'\\
 option network 'tcp,udp'\\
 option domain_list 'gdmf.apple.com\\
mesu.apple.com'\\
 option group 'CN'\\
" "$CFG"; \
sed -i "/^config shunt_rules 'CN'$/,/^config /{s|option domain_list 'geosite:cn'|option domain_list 'geosite:cn\\
geosite:apple'|;s|option ip_list 'geoip:cn'|option ip_list 'geoip:cn\\
17.0.0.0/8'|;}" "$CFG"; \
sed -i "/config nodes 'rulenode'/,/^config /{/option PrivateIP '_direct'/a\\
 option AppleBlack '_blackhole'\\
 option DirectFront '_direct'\\
 option DirectGame '_direct'\\
 option CN '_direct'
}" "$CFG"

修改argon为默认主题

1

sed -i "s/luci-theme-bootstrap/luci-theme-argon/g" $(find ./feeds/luci/collections/ -type f -name "Makefile")

修改默认时区为上海

1
2


sed -i "s/set system.@system\[-1\]\.timezone='GMT0'/set system.@system[-1].timezone='CST-8'/" package/base-files/files/bin/config_generate && \
sed -i "s/set system.@system\[-1\]\.zonename='UTC'/set system.@system[-1].zonename='Asia\\/Shanghai'/" package/base-files/files/bin/config_generate

使用图形界面配置固件

1

make menuconfig

选择LuCI网页管理界面

进入：

1
2
3


LuCI --->
 Collections --->
 <*> luci

将 luci 设置为 <*>，确保网页管理界面被编译进固件。

选择LuCI简体中文

进入：

1
2
3
4


LuCI --->
 Modules --->
 Translations --->
 <*> Chinese Simplified (zh_Hans)

如果菜单位置发生变化，也可以在 menuconfig 中按 / 搜索：

1

zh_Hans

找到对应的 LuCI 简体中文语言包并选中。

选择常用LuCI应用

进入：

1
2


LuCI --->
 Applications --->

选中：

1
2
3
4
5


<*> luci-app-ddns
<*> luci-app-upnp
<*> luci-app-vlmcsd
<*> luci-app-wol
<*> luci-app-nlbwmon

分别对应：

DDNS
UPnP
KMS
WOL网络唤醒
NLBWMon（Netlink Bandwidth Monitor，网络带宽监控）

调整Root分区大小为512M

进入：

1

Target Images --->

找到：

1

(160) Root filesystem partition size (in MiB)

将：

1

160

修改为：

1

512

最终对应配置为：

1

CONFIG_TARGET_ROOTFS_PARTSIZE=512

如果插件较多，也可以根据需要调整为 1024 MiB。

修改网关地址(可选)

1
2


sed -i "s/192\.168\.[0-9]*\.[0-9]*/10.0.0.1/g" $(find ./feeds/luci/modules/luci-mod-system/ -type f -name "flash.js") && \
sed -i "s/192\.168\.[0-9]*\.[0-9]*/10.0.0.1/g" ./package/base-files/files/bin/config_generate

下载dl库

1

make -j8 download V=s

编译固件

1

make FORCE_UNSAFE_CONFIGURE=1 -j1 V=s

Docker on 梓晨's Blog

Docker 一键部署青龙面板

一键部署

参数说明

延伸阅读

Docker 一键部署 Samba 文件共享

一键部署

连接共享

共享参数说明

延伸阅读

Docker 一键部署 Runo API 客户端

一键部署

参数说明

延伸阅读

Docker 部署 Hoppscotch 前端

一键安装命令

验证与停止

延伸阅读

Docker 部署 Zigbee2MQTT

安装命令

2.x 及后续版本配置

通过命令开启配对

1.x 配置格式

USB 协调器

延伸阅读

Docker 部署 Home Assistant Container

安装命令

验证运行状态

备份与恢复

临时停止容器

延伸阅读

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

前言

下载镜像配置

切换到构建目录

构建镜像

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

配置热插拔

延伸阅读

Docker 使用 macvlan 部署 OpenWrt 旁路由

配置系统环境

创建接口

创建容器

配置 OpenWrt

宿主机通信：ifupdown 配置示例

延伸阅读

Docker 部署 Aria2 RPC 下载服务

一键快速部署命令

一键修改为空密钥

延伸阅读

Docker 部署 Poste.io 邮件服务器

前言

关于Poste

准备工作

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

一键快速部署命令

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

Linux 安装 Docker Engine 与 Docker Compose

适用范围

RPM 系统：CentOS Stream

RPM 系统：RHEL

Debian 软件源

Ubuntu 软件源

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

Debian/Ubuntu 安装与启动

验证安装

可选：配置 Docker Hub 镜像加速

可选：一键安装 Compose 独立版

Compose V1：旧环境安装记录

延伸阅读

Docker 编译 ImmortalWrt（Ubuntu 24.04 容器示例）

宿主机与容器环境

下载镜像

启动容器

进入容器

更换为国内apt源

更新apt列表

安装必要扩展

下载openwrt源码

添加helloworld支持库