家用 Proxmox VE 全栈部署指南
家用 Proxmox VE 全栈部署指南
从空盘到全功能家庭服务器:BT 下载 · 影视媒体 · 智能家居 · Windows 虚拟机 · DNS 去广告 · 反向代理 · 自动备份
环境信息: Proxmox VE 8.x · i5-11400 6C/12T · 32GB DDR4 · 100TB+ 存储 · Debian 12 · Docker
硬件盘点
| 部件 | 规格 | 角色定位 |
|---|---|---|
| CPU | Intel i5-11400(6核12线程) | 够用但需合理分配 vCPU |
| 内存 | 32GB DDR4(16G×2) | 中等,需精打细算 |
| 500G SSD | 系统盘 | PVE 系统 + Win11 + HA(高 IOPS) |
| 1T SSD | 应用盘 | Docker VM + NAS VM + LXC 容器 |
| 6×16T HDD | 主力数据盘 | ZFS RAIDZ2,可用 64TB |
| 2T HDD | 下载盘 | BT 下载临时存储 |
| 6T HDD | 冷备盘 | 重要数据二次备份 |
存储架构图
500G SSD (系统盘) 1T SSD (应用盘)
├── PVE 系统 + swap (~80G) ├── Docker Host VM (~100G)
├── Win11 虚拟磁盘 (~120G) ├── NAS VM (~100G)
├── HA VM 磁盘 (~32G) ├── NPM LXC (~10G)
└── LXC 模板 (~剩余) ├── AdGuard LXC (~4G)
└── 剩余 / 缓存
6×16T HDD → ZFS RAIDZ2 (tank) 64TB 2T HDD (下载盘) 6T HDD (冷备盘)
├── /tank/media/movies └── /downloads └── /coldbackup
├── /tank/media/tvshows ← BT 下载落地 ← 定期 rsync
├── /tank/media/music
├── /tank/media/anime
├── /tank/photos
├── /tank/documents
└── /tank/backups
网络拓扑(主路由 192.168.9.1)
┌──────────────┐
│ 家庭主路由器 │
│ 192.168.9.1 │
└──────┬───────┘
│
┌──────┴───────┐
│ PVE 宿主机 │
│ 192.168.9.2 │
│ (vmbr0) │
└──────┬───────┘
│
┌─────────┬───────────┼──────────┬────────────┐
│ │ │ │ │
┌────┴──┐ ┌───┴──┐ ┌──────┴─┐ ┌──────┴──┐ ┌──────┴──┐
│ Win11 │ │ HA │ │ NAS │ │ Docker │ │ NPM │
│ .9.11 │ │ .9.20│ │ .9.30 │ │ .9.40 │ │ .9.50 │
└───────┘ └──────┘ └────────┘ └─────────┘ └─────────┘
┌──────────┐
│ AdGuard │
│ .9.53 │
└──────────┘
DNS 链路: 设备 → AdGuard(.9.53) → DNS重写 → NPM(.9.50) → 反代到各服务
VM / 容器分配总览
| # | 名称 | 类型 | vCPU | 内存 | 磁盘 | 存储位置 | IP |
|---|---|---|---|---|---|---|---|
| 1 | Windows 11 | VM | 4 | 8G | 120G | 500G SSD | 192.168.9.11 |
| 2 | Home Assistant | VM | 2 | 2G | 32G | 500G SSD | 192.168.9.20 |
| 3 | NAS (OMV/TrueNAS) | VM | 2 | 4G | 100G | 1T SSD | 192.168.9.30 |
| 4 | Docker Host | VM | 2 | 8G | 100G | 1T SSD | 192.168.9.40 |
| 5 | Nginx Proxy Manager | LXC | 1 | 512M | 8G | 1T SSD | 192.168.9.50 |
| 6 | AdGuard Home | LXC | 1 | 512M | 4G | 1T SSD | 192.168.9.53 |
资源核算
- 内存:4(PVE) + 8(Win11) + 2(HA) + 4(NAS) + 8(Docker) + 0.5(NPM) + 0.5(AdGuard) = 27GB,剩余 ~5GB 给 PVE 缓存。
- vCPU:4+2+2+2+1+1 = 12 vCPU = 物理线程数,不超分,性能有保障。
Docker Host 上的容器清单
| 容器 | 说明 | 镜像 / 端口 |
|---|---|---|
| qBittorrent | BT 下载主力,WebUI 管理端口 8080 | linuxserver/qbittorrent · :8080 |
| Aria2 + AriaNg | 多协议下载(HTTP/FTP/BT/磁力) | p3terx/aria2-pro · :6800 |
| Jellyfin | 影视媒体服务器,免费开源 | linuxserver/jellyfin · :8096 |
| Navidrome | 音乐流媒体服务器 | deluan/navidrome · :4533 |
| Photoprism | 照片管理,Google Photos 替代 | photoprism/photoprism · :2342 |
| Vaultwarden | 密码管理,Bitwarden 轻量版 | vaultwarden/server · :8222 |
| Uptime Kuma | 服务监控面板 | louislam/uptime-kuma · :3001 |
| Memos | 备忘录,类 flomo | neosmemo/memos · :5230 |
Step 1:安装 Proxmox VE 系统
1.1 下载 PVE 安装镜像
从官网下载 Proxmox VE 8.x ISO 镜像,用 Rufus 或 Ventoy 制作启动 U 盘。
# 官方下载页面
https://www.proxmox.com/en/downloads
# 或直接下载 ISO(以 8.2 为例)
wget https://download.proxmox.com/debian/pve/iso/proxmox-ve_8.2-1.iso
1.2 BIOS 设置
- 开机按
Del/F2进入 BIOS - 开启 VT-x / VT-d(虚拟化 + IOMMU,后续直通需要)
- 设置 启动模式为 UEFI(推荐)
- 将 500G SSD 设为第一启动项
- 保存退出
1.3 安装过程
- U 盘启动,选择
Install Proxmox VE - Target Harddisk:选择 500G SSD(
/dev/nvme0n1或/dev/sda) - Filesystem:选择
ext4(单盘系统不需要 ZFS) - Country/Time zone:China / Asia/Shanghai
- Keyboard Layout:US English
- Administration:设置 root 密码(务必记住)
- Network:
- Management Interface: 选择有线网卡
- Hostname:
pve.home.lan - IP Address:
192.168.9.2/24 - Gateway:
192.168.9.1 - DNS:
192.168.9.1
- 点击 Install,等待完成,重启
安装完成验证: 重启后浏览器访问
https://192.168.9.2:8006,用户名root,密码为安装时设置的密码,Realm 选PAM。能看到 PVE 管理界面即安装成功。
Step 2:PVE 基础配置
2.1 更换国内源(加速 apt 更新)
# 备份原源
cp /etc/apt/sources.list /etc/apt/sources.list.bak
# 替换为清华源
cat > /etc/apt/sources.list << 'EOF'
deb https://mirrors.tuna.tsinghua.edu.cn/debian/ bookworm main contrib non-free-firmware
deb https://mirrors.tuna.tsinghua.edu.cn/debian/ bookworm-updates main contrib non-free-firmware
deb https://mirrors.tuna.tsinghua.edu.cn/debian/ bookworm-backports main contrib non-free-firmware
deb https://mirrors.tuna.tsinghua.edu.cn/debian-security/ bookworm-security main contrib non-free-firmware
EOF
# 替换 PVE 企业源为免费源
rm -f /etc/apt/sources.list.d/pve-enterprise.list
cat > /etc/apt/sources.list.d/pve-no-subscription.list << 'EOF'
deb https://mirrors.tuna.tsinghua.edu.cn/proxmox/debian/pve bookworm pve-no-subscription
EOF
# 替换 Ceph 源(如需要)
cat > /etc/apt/sources.list.d/ceph.list << 'EOF'
deb https://mirrors.tuna.tsinghua.edu.cn/proxmox/debian/ceph-quincy bookworm no-subscription
EOF
# 更新
apt update && apt full-upgrade -y
2.2 去除未订阅提示
sed -i.bak "s/res === null || res === undefined || !res || res/data.status !== 'active'/g" /usr/share/javascript/proxmox-widget-toolkit/proxmoxlib.js
systemctl restart pveproxy
2.3 开启 IOMMU(为后续硬件直通准备)
sed -i 's/GRUB_CMDLINE_LINUX_DEFAULT="quiet"/GRUB_CMDLINE_LINUX_DEFAULT="quiet intel_iommu=on iommu=pt"/' /etc/default/grub
update-grub
reboot
重启后执行
dmesg | grep -e DMAR -e IOMMU,看到DMAR: IOMMU enabled则成功。
2.4 创建 ZFS 存储池(6×16T RAIDZ2)
lsblk -o NAME,SIZE,TYPE,MOUNTPOINT
# 创建 RAIDZ2 存储池(双盘冗余,允许同时坏 2 盘)
zpool create -f -o ashift=12 tank raidz2 /dev/sdb /dev/sdc /dev/sdd /dev/sde /dev/sdf /dev/sdg
zfs set compression=lz4 tank
zfs set atime=off tank
zfs set xattr=sa tank
zpool status tank
zfs list tank
⚠️ 设备名确认至关重要: 务必先用
lsblk确认 6 块 16T 盘的实际设备名,选错盘会覆盖数据!建议用/dev/disk/by-id/路径代替/dev/sdX。
2.5 格式化下载盘和冷备盘
mkfs.ext4 -L downloads /dev/sdh
mkdir -p /mnt/downloads
mount /dev/sdh /mnt/downloads
mkfs.ext4 -L coldbackup /dev/sdi
mkdir -p /mnt/coldbackup
mount /dev/sdi /mnt/coldbackup
echo "UUID=$(blkid -s UUID -o value /dev/sdh) /mnt/downloads ext4 defaults 0 2" >> /etc/fstab
echo "UUID=$(blkid -s UUID -o value /dev/sdi) /mnt/coldbackup ext4 defaults 0 2" >> /etc/fstab
2.6 在 PVE 中注册存储
- Datacenter → Storage → Add → Directory:ID=
downloads, Directory=/mnt/downloads - Datacenter → Storage → Add → ZFS:ID=
tank, ZFS Pool=tank
2.7 配置 NFS 共享
apt install -y nfs-kernel-server
cat > /etc/exports << 'EOF'
/tank/media 192.168.9.0/24(rw,sync,no_subtree_check,no_root_squash)
/tank/photos 192.168.9.0/24(rw,sync,no_subtree_check,no_root_squash)
/tank/documents 192.168.9.0/24(rw,sync,no_subtree_check,no_root_squash)
/mnt/downloads 192.168.9.0/24(rw,sync,no_subtree_check,no_root_squash)
EOF
exportfs -ra
systemctl restart nfs-kernel-server
Step 3:创建存储目录结构
zfs create tank/media
zfs create tank/media/movies
zfs create tank/media/tvshows
zfs create tank/media/music
zfs create tank/media/anime
zfs create tank/photos
zfs create tank/documents
zfs create tank/backups
chmod -R 777 /tank/media
chmod -R 777 /tank/photos
chmod -R 777 /tank/documents
chmod -R 777 /mnt/downloads
设置 ZFS 自动快照
cat > /usr/local/bin/zfs-snap.sh << 'SCRIPT'
#!/bin/bash
DATE=$(date +%Y%m%d)
zfs snapshot tank@daily-$DATE
zfs list -t snapshot -o name -H | grep "tank@daily-" | sort | head -n -7 | while read snap; do
zfs destroy "$snap"
done
SCRIPT
chmod +x /usr/local/bin/zfs-snap.sh
echo "0 2 * * * /usr/local/bin/zfs-snap.sh" >> /etc/crontab
Step 4:部署 AdGuard Home(DNS 去广告)
AdGuard Home 作为全屋 DNS 服务器,拦截广告 + 内网域名解析。用 LXC 容器部署,轻量高效。
4.1 创建 LXC 容器
# 下载 Debian 12 模板
pveam update
pveam download local debian-12-standard_12.2-1_amd64.tar.zst
# 创建 LXC 容器
pct create 200 local:vztmpl/debian-12-standard_12.2-1_amd64.tar.zst \
--hostname adguard \
--arch amd64 \
--ostype debian \
--cores 1 \
--memory 512 \
--rootfs local:4 \
--net0 name=eth0,bridge=vmbr0,ip=192.168.9.53/24,gw=192.168.9.1 \
--unprivileged 0
# 启动
pct start 200
pct enter 200
4.2 安装 AdGuard Home
# 在 LXC 内执行
apt update && apt install -y curl
# 一键安装
curl -s -L https://raw.githubusercontent.com/AdguardTeam/AdGuardHome/master/scripts/install.sh | sh -s -- -v
# 编辑配置,设置 DNS 重写
cat > /opt/AdGuardHome/conf/AdGuardHome.yaml << 'YAML'
bind_port: 53
dns:
bind_hosts:
- 0.0.0.0
upstream_dns:
- https://dns.alidns.com/dns-query
- https://doh.pub/dns-query
bootstrap_dns:
- 223.5.5.5
- 119.29.29.29
rewrites:
- domain: '*.home.lan'
answer: 192.168.9.50
- domain: 'adguard.home.lan'
answer: 192.168.9.53
- domain: 'jellyfin.home.lan'
answer: 192.168.9.40
- domain: 'npm.home.lan'
answer: 192.168.9.50
- domain: 'vault.home.lan'
answer: 192.168.9.40
- domain: 'photos.home.lan'
answer: 192.168.9.40
- domain: 'music.home.lan'
answer: 192.168.9.40
- domain: 'kuma.home.lan'
answer: 192.168.9.40
- domain: 'win.home.lan'
answer: 192.168.9.11
- domain: 'ha.home.lan'
answer: 192.168.9.20
- domain: 'nas.home.lan'
answer: 192.168.9.30
filtering_enabled: true
filters:
- url: https://anti-ad.net/clash-rules.txt
name: anti-AD
enabled: true
- url: https://raw.githubusercontent.com/AdguardTeam/AdGuardSDNSFilter/master/Filters/filter.txt
name: AdGuard DNS filter
enabled: true
YAML
# 重启 AdGuard
systemctl restart AdGuardHome
DNS 重写说明:
*.home.lan泛解析到 NPM(192.168.9.50),由 NPM 反代到各服务。其他域名直接指向对应 IP。
4.3 将主路由 DNS 指向 AdGuard
登录家庭路由器管理界面,将 LAN 口 DNS 服务器改为 192.168.9.53。所有连接 WiFi 的设备将自动使用 AdGuard 解析。
Step 5:部署 Nginx Proxy Manager(反向代理)
NPM 提供可视化反向代理管理,自动申请 Let’s Encrypt 证书(内网用自签证书)。
5.1 创建 LXC 容器
pct create 201 local:vztmpl/debian-12-standard_12.2-1_amd64.tar.zst \
--hostname npm \
--arch amd64 \
--ostype debian \
--cores 1 \
--memory 512 \
--rootfs local:8 \
--net0 name=eth0,bridge=vmbr0,ip=192.168.9.50/24,gw=192.168.9.1 \
--unprivileged 1
pct start 201
pct enter 201
5.2 安装 Docker + NPM
# 安装 Docker
curl -fsSL https://get.docker.com | sh
# 启动 NPM
docker run -d \
--name npm \
--restart unless-stopped \
-p 80:80 \
-p 81:81 \
-p 443:443 \
-v /opt/npm/data:/data \
-v /opt/npm/letsencrypt:/etc/letsencrypt \
jc21/nginx-proxy-manager:latest
5.3 配置反向代理
访问 http://192.168.9.50:81,默认账号 admin@example.com / changeme。
添加 Proxy Host 示例(Jellyfin):
| 字段 | 值 |
|---|---|
| Domain Names | jellyfin.home.lan |
| Scheme | http |
| Forward Hostname / IP | 192.168.9.40 |
| Forward Port | 8096 |
| Block Common Exploits | ✅ |
| Websockets Support | ✅ |
在 SSL 标签页选择 Request a new SSL Certificate,勾选 Force SSL。由于内网域名,需在 AdGuard 的 DNS 重写中添加对应解析。
其他 Proxy Host 同理添加:
| 域名 | 转发 IP | 端口 |
|---|---|---|
npm.home.lan |
192.168.9.50 | 81 |
vault.home.lan |
192.168.9.40 | 8222 |
photos.home.lan |
192.168.9.40 | 2342 |
music.home.lan |
192.168.9.40 | 4533 |
kuma.home.lan |
192.168.9.40 | 3001 |
ha.home.lan |
192.168.9.20 | 8123 |
nas.home.lan |
192.168.9.30 | 80 |
win.home.lan |
192.168.9.11 | 3389 |
Step 6:创建 Docker Host VM
6.1 创建虚拟机
# 下载 Debian 12 ISO
wget -P /var/lib/vz/template/iso/ https://mirrors.tuna.tsinghua.edu.cn/debian-cd/current/amd64/iso-dvd/debian-12.2.0-amd64-DVD-1.iso
# 创建 VM
qm create 400 --name docker --ostype l26 \
--cores 2 --memory 8192 --balloon 2048 \
--net0 virtio,bridge=vmbr0 \
--scsi0 local:100,format=qcow2 \
--scsihw virtio-scsi-pci \
--ide2 local:iso/debian-12.2.0-amd64-DVD-1.iso,media=cdrom \
--boot order=scsi0 \
--agent enabled=1
qm set 400 --ipconfig0 ip=192.168.9.40/24,gw=192.168.9.1
qm start 400
6.2 安装 Debian + Docker
通过 PVE Web 控制台完成 Debian 安装(最小安装,不装桌面)。安装后 SSH 登录:
# 更新系统
apt update && apt full-upgrade -y
# 安装基础工具
apt install -y curl wget git htop nano
# 安装 Docker
curl -fsSL https://get.docker.com | sh
# 配置 Docker 镜像加速
mkdir -p /etc/docker
cat > /etc/docker/daemon.json << 'EOF'
{
"registry-mirrors": [
"https://docker.m.daocloud.io",
"https://dockerproxy.com",
"https://docker.nju.edu.cn"
],
"log-driver": "json-file",
"log-opts": {
"max-size": "10m",
"max-file": "3"
}
}
EOF
systemctl restart docker
6.3 挂载 NFS 共享
apt install -y nfs-common
mkdir -p /mnt/media /mnt/photos /mnt/documents /mnt/downloads
cat >> /etc/fstab << 'EOF'
192.168.9.2:/tank/media /mnt/media nfs rw,soft,_rnetdev 0 0
192.168.9.2:/tank/photos /mnt/photos nfs rw,soft,_rnetdev 0 0
192.168.9.2:/tank/documents /mnt/documents nfs rw,soft,_rnetdev 0 0
192.168.9.2:/mnt/downloads /mnt/downloads nfs rw,soft,_rnetdev 0 0
EOF
mount -a
df -h /mnt/media /mnt/photos /mnt/documents /mnt/downloads
6.4 创建 docker-compose.yml
mkdir -p /opt/docker/config
cd /opt/docker
完整的 docker-compose.yml 见文末附录 A1。创建后执行:
docker compose up -d
docker compose ps
Step 7:创建 Home Assistant VM
7.1 下载 HAOS 镜像
# 下载 HAOS x86-64 虚拟磁盘
wget -P /tmp/ https://github.com/home-assistant/operating-system/releases/download/11.4/haos_ova-11.4.qcow2.xz
# 解压
xz -d /tmp/haos_ova-11.4.qcow2.xz
- 点赞
- 收藏
- 关注作者
评论(0)