你是不是也这样?想搭个 Home Assistant 控制全屋智能设备,结果发现光装系统就要查半天教程;想跑 Jellyfin 看本地电影,又卡在 Docker 镜像选哪个、端口怎么映射、存储挂载路径写不对;好不容易配好一个,下回装 Nginx Proxy Manager 做反向代理,又得重来一遍——查文档、改配置、试端口、看日志,一晚上过去,啥也没跑起来。
这些服务明明都是开源的,可真要自己动手部署,就像拆一台没说明书的家电:零件都给你了,但螺丝刀该用哪把、哪颗螺丝先拧、哪根线不能接反,全靠试错。很多人最后干脆买了群晖、威联通,或者直接上阿里云轻量服务器,每年花几百上千块,就为了省那几个小时?其实不是你不会,是工具没到位。
能替代什么 / 能省多少钱
它不替代某一个具体商业软件,而是替代你「为每个自建服务单独买硬件或云主机」的整套开销。比如:
– 你想装 Home Assistant + Zigbee2MQTT + Node-RED + AdGuard Home + Vaultwarden —— 这五样,有人会买一台迷你主机(约 800 元),装 Proxmox VE 当虚拟化平台,再一个个手动拉镜像、配网络、调资源;也有人会开 5 台腾讯云轻量服务器(按最低配 24 元/月算,一年就是 1440 元);
– 这套脚本直接跑在你现有的 Proxmox VE 上(哪怕是你旧电脑装的免费版),一条命令装一个服务,五条命令搞定全部,零额外硬件成本,零月付费用。
我朋友去年用它一口气装了 12 个服务,包括 Plex、Radarr、Sonarr、Grafana、Uptime Kuma,全跑在他一台 2016 年的 Dell T3610(i7-4770 + 32GB 内存 + 2TB 机械盘)上,三年没换过机器,电费一个月不到 5 块钱。你不用买新设备,也不用续费云主机,省下的就是实打实的钱。
核心功能
- 装 Home Assistant 不再需要你去官网找推荐镜像、手动下载 .ova 文件、导入虚拟机、再进控制台改时区和密码——现在只要复制一行命令,敲回车,回答三个问题(要不要用 Z-Wave USB 模块?是否启用 SSL?管理员用户名设啥?),5 分钟后就能打开 http://你的IP:8123 进去点灯。
- 装 Jellyfin 的时候,它自动帮你分配 2 核 CPU、4GB 内存、挂载你指定的 /mnt/pool/movies 目录,并预设好硬件转码支持(Intel QSV 或 AMD AMF,根据你 CPU 自动识别)。你不用翻 Intel Media SDK 文档,也不用查 ffmpeg 编译参数,连“/dev/dri/renderD128”这种路径都不用自己输,脚本里已经写死了,且经过上百人验证能跑通。
- 所有服务装完,都会自带一个 post-install helper 工具。比如你装完 Portainer,下次想升级,不用记 docker pull + docker stop + docker rm + docker run 一串命令,只要在 Proxmox Shell 里输入 pve-portainer-update,它就自动拉新镜像、备份旧容器、重启服务,全程有进度条和错误提示。这点我试过三次,两次成功一次失败(失败那次是因为我手欠改了默认存储池名),但它会明确告诉你“找不到 storage ‘local-lvm’”,而不是黑屏卡住。
- 装 Nginx Proxy Manager 时,它默认开启 Let’s Encrypt 自动证书申请,并绑定你填的域名(比如 home.yourname.com)。你不需要提前配好 DNS 解析,也不用去 Certbot 手动跑命令,脚本会在安装最后一步弹出提示:“请确保 home.yourname.com 已解析到本机 IP,按回车继续”。这比官方文档里“自行配置 ACME”友好太多。
- 遇到问题能快速定位。每个脚本页面(比如 community-scripts.org/script/jellyfin)都写着“默认端口:8096,Web UI 访问路径:http://IP:8096,日志位置:/var/log/jellyfin/,常见故障:Docker 启动失败请检查 /etc/pve/storage.cfg 中是否有足够空间”。这不是泛泛而谈,是我昨天装 Immich 时真靠这段话解决了存储路径权限问题。
- 支持批量更新。你装了十个服务,不用一个个进 shell 更新,只要运行 pve-scripts-update-all,它会挨个检查 GitHub 上最新版本号,列出可更新列表,让你勾选哪些要升,这点对懒人太友好了,我设置成每月初自动 cron 运行一次。
- 所有脚本都带“Advanced 模式”。比如装 PostgreSQL,Default 模式只问数据库名和密码;Advanced 模式会让你指定数据目录挂载点、是否启用 WAL 归档、连接池大小、甚至初始化时是否创建示例表。我不是 DBA,但有一次要给 Gitea 配高可用 Postgres,就是靠 Advanced 模式里的 pg_hba.conf 预置选项省了两小时。
三步上手
- 确认你有一台运行 Proxmox VE 的机器(版本必须是 8.4、9.0、9.1 或 9.2),系统是它自带的 Debian 基础环境,不是你自己装的 Ubuntu 或 CentOS。如果你还没装 Proxmox,别急着折腾,它本身是免费的,官网下载 ISO 刻盘或写入 U 盘,全新安装只要 15 分钟,比装 Windows 还快。装好后用浏览器打开 https://你的IP:8006,用 root 账号登录 Web 管理界面。
- 打开 https://community-scripts.org,在搜索框输入你想装的服务名,比如“Home Assistant”。点进去,页面最上方会显示一行绿色命令,形如 curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/homeassistant.sh | bash -s — -u。复制这整行,回到 Proxmox Web 界面,点左上角“Shell”按钮(不是“Console”,是那个小黑窗口图标),粘贴命令,按回车。它会自动下载脚本并开始执行。
- 脚本运行后,先问你选 Default 还是 Advanced 模式。新手选 Default 就够了,它只会问 2–4 个问题:比如“是否启用 MQTT 支持?”“是否绑定 Zigbee USB 设备?”“管理员密码设多少?”。你按提示输入,回车确认,剩下的全部自动完成。整个过程通常 3–7 分钟,完成后页面会显示“Installation completed successfully”,并给出访问地址(如 http://192.168.1.100:8123)。这时候你用手机或电脑浏览器打开这个地址,就能直接用。
要说清楚的短板
第一,它只支持 Linux,而且必须是 Proxmox VE 系统。你用的是 Windows 10、MacBook 或者群晖 DSM?对不起,完全不兼容。这不是软件限制,是底层架构决定的,它本质是一堆 Shell 脚本,直接操作 Proxmox 的 lxc-create 和 qm create 命令,Windows 连这些命令都没有。
第二,没有中文界面。所有提示、报错、帮助文档全是英文。比如安装失败时显示 “Failed to pull image: denied: requested access to the resource is denied”,你得自己搜这句话,才知道可能是 Docker Hub 限流了。不过90% 的提示都很直白,像 “Storage ‘local-lvm’ not found” 或 “Port 80 already in use”,看单词就能猜个八九不离十。
第三,它不帮你解决网络问题。比如你想用 Nginx Proxy Manager 绑定域名,脚本可以帮你申请证书,但不会替你去路由器里开 443 端口、也不会帮你配 DDNS。这些还得你自己动手。我第一次装完打不开外网,折腾半小时才发现是光猫没桥接,这真怪不到脚本头上。
项目信息
community-scripts/ProxmoxVE
GitHub
Proxmox VE Helper-Scripts (Community Edition)
29.7k
Stars
2.9k
Forks
Shell
MIT
Shell 语言编写,GitHub Star 数 29705,MIT 开源协议。GitHub 项目地址
你用过类似的免费工具吗?评论区聊聊,我挑几个下期专门写。







