家用 Proxmox VE 全栈部署指南

举报
qinrui 发表于 2026/11/17 14:52:16 2026/11/17
【摘要】 家用 Proxmox VE 全栈部署指南从空盘到全功能家庭服务器:BT 下载 · 影视媒体 · 智能家居 · Windows 虚拟机 · DNS 去广告 · 反向代理 · 自动备份环境信息: Proxmox VE 8.x · i5-11400 6C/12T · 32GB DDR4 · 100TB+ 存储 · Debian 12 · Docker 硬件盘点部件规格角色定位CPUIntel i...

家用 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 设置

  1. 开机按 Del / F2 进入 BIOS
  2. 开启 VT-x / VT-d(虚拟化 + IOMMU,后续直通需要)
  3. 设置 启动模式为 UEFI(推荐)
  4. 将 500G SSD 设为第一启动项
  5. 保存退出

1.3 安装过程

  1. U 盘启动,选择 Install Proxmox VE
  2. Target Harddisk:选择 500G SSD(/dev/nvme0n1 或 /dev/sda)
  3. Filesystem:选择 ext4(单盘系统不需要 ZFS)
  4. Country/Time zone:China / Asia/Shanghai
  5. Keyboard Layout:US English
  6. Administration:设置 root 密码(务必记住)
  7. Network:
    • Management Interface: 选择有线网卡
    • Hostname: pve.home.lan
    • IP Address: 192.168.9.2/24
    • Gateway: 192.168.9.1
    • DNS: 192.168.9.1
  8. 点击 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 中注册存储

  1. Datacenter → Storage → Add → Directory:ID=downloads, Directory=/mnt/downloads
  2. 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
【版权声明】本文为华为云社区用户原创内容,未经允许不得转载,如需转载请自行联系原作者进行授权。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。