HN 공개: Proxmox VE 보조 스크립트

 (community-scripts.github.io)
3P by GN⁺ | ★ favorite | 댓글 1개
  • Proxmox VE 운영자는 컨테이너와 VM 배포·관리를 반복 작업으로 처리하는 경우가 많아, 단일 명령 기반 커뮤니티 스크립트 허브가 homelab과 가상화 운영을 줄여줌
  • 사이트는 604개 스크립트, 4,497,254회 설치, 26개 카테고리를 내세우며 Proxmox 환경용 자동화 스크립트를 한곳에서 탐색하게 함
  • 최근 30일 최다 설치 목록에는 Docker, Debian, Immich, Nginx Proxy Manager, Jellyfin Media Server처럼 homelab에서 자주 쓰는 서비스가 포함됨
  • 새로 추가된 스크립트는 LXC, ARM LXC, PVE 유형으로 나뉘며 Koffan, Etherpad, Flame, PVE Disk Health Tool, Pinchflat, SnapOtter 등이 보임
  • 시스템에서 바로 실행되는 스크립트인 만큼 공식 사이트 확인과 스크립트 소스 검토가 설치 전 필수임

Proxmox VE용 커뮤니티 스크립트 허브

  • Proxmox VE Helper-Scripts는 Proxmox VE용 커뮤니티 기반 자동화 스크립트를 모아 제공함
  • 사용자는 Proxmox 환경에서 컨테이너와 VM을 단일 명령으로 탐색, 설치, 관리할 수 있음
  • homelab과 가상화 워크플로우를 단순화하는 중앙 허브 역할을 함
  • 사이트 규모는 다음과 같음

    • 604개 스크립트

    • 4,497,254회 설치

      • 26개 카테고리

새 홈페이지와 탐색 흐름

  • 2026년 3월 6일 업데이트로 Proxmox VE Community Scripts 프로젝트의 새 홈페이지가 공개됨
  • 새 웹사이트는 Proxmox 환경을 위한 수백 개 자동화 스크립트를 더 쉽게 발견, 탐색, 배포하도록 구성됨
  • 커뮤니티가 만든 플랫폼이며 homelab과 가상화 워크플로우를 단순화하는 허브로 제공됨

최근 30일 최다 설치 스크립트

  • 인기 목록은 최근 30일 설치 수 기준으로 정렬됨
  • 상위 항목은 다음과 같음
    • Docker: 오픈소스 애플리케이션 배포 자동화 프로젝트, 30,594회 설치
    • Debian: 59,000개 이상 패키지를 포함한 무료 운영체제, 22,397회 설치
    • Immich: 셀프호스팅 사진·동영상 관리 솔루션, 18,234회 설치
    • Nginx Proxy Manager: Nginx 리버스 프록시 관리를 위한 웹 기반 인터페이스, 14,049회 설치
    • Jellyfin Media Server: 디지털 미디어 파일을 정리, 관리, 공유하는 무료 오픈소스 미디어 서버, 13,707회 설치
    • Hermes Agent: Nous Research의 자기 개선 AI 에이전트, 13,233회 설치
    • Frigate: IP 카메라용 실시간 AI 객체 감지 기반 오픈소스 NVR, 12,663회 설치
    • AdGuard Home: 셀프호스팅 네트워크 전체 광고 차단 도구, 12,532회 설치
    • Ollama: 로컬 컴퓨터에서 대규모 언어 모델을 실행하는 도구, 11,923회 설치
    • Ubuntu: Debian 기반 배포판, 10,689회 설치

새로 추가된 스크립트

  • 최근 추가 목록은 스크립트 이름, 유형, 추가 시점을 함께 보여줌
  • 주요 항목은 다음과 같음
    • iVentoy: 여러 머신에서 네트워크를 통한 OS 부팅과 설치를 동시에 지원하는 PXE 서버, 오늘 추가
    • FMD-Server: Android 기기 위치 확인과 원격 제어를 위한 분산형 도구, 1일 전 추가
    • Koffan: 커플과 가족을 위한 실시간 동기화 쇼핑 리스트 웹 앱, 1일 전 추가
    • Etherpad: 브라우저에서 여러 사람이 동시에 편집하는 실시간 협업 문서 편집기, 1일 전 추가
    • Flame: 서버용 셀프호스팅 시작 페이지, 1일 전 추가
    • PVE Disk Health Tool: Proxmox VE 호스트의 물리 디스크 상태를 보고하는 도구, 2일 전 추가
    • Pinchflat: yt-dlp 기반 셀프호스팅 YouTube 미디어 관리자, 4일 전 추가
    • SnapOtter: 로컬 실행 기반 이미지 처리 도구 모음, 6일 전 추가
    • Postiz: 여러 소셜 플랫폼의 게시물 예약과 관리를 위한 AI 기반 도구, 9일 전 추가
    • Plane: 이슈, 사이클, 모듈로 소프트웨어 프로젝트를 계획하고 추적하는 오픈소스 도구, 11일 전 추가

개발 중인 스크립트

  • 개발 중 섹션의 스크립트는 아직 공식 릴리스되지 않았고 활발히 개발 중인 상태임
  • 표시된 개발 중 항목은 다음과 같음
    • Rackula: homelab 사용자를 위한 드래그 앤 드롭 랙 레이아웃 디자이너
    • Umbraco CMS: 오픈소스 .NET CMS와 FTP 서버 자동 설정 스크립트
    • Nexterm: SSH, VNC, RDP용 오픈소스 서버 관리 소프트웨어
    • Colanode: 셀프호스팅 Slack·Notion 대안인 로컬 우선 협업 워크스페이스
    • ExcaliDash: Excalidraw용 셀프호스팅 대시보드와 정리 도구

카테고리 구성

  • 스크립트는 Proxmox와 운영체제, 네트워크, 보안, 백업, 데이터베이스, 모니터링, 미디어, IoT 등 여러 범주로 나뉨
  • 주요 카테고리와 전체 수는 다음과 같음
    • Proxmox & Virtualization: 40개
    • Operating Systems: 27개
    • Containers & Docker: 10개
    • Network & Firewall: 40개
    • Adblock & DNS: 8개
    • Authentication & Security: 21개
    • Backup & Recovery: 11개
    • Databases: 24개
    • Monitoring & Analytics: 50개
    • Dashboards & Frontends: 17개
    • Files & Downloads: 35개
    • Documents & Notes: 59개
    • Media & Streaming: 58개
    • AI / Coding & Dev-Tools: 35개

스크립트 유형과 예시

  • 각 스크립트는 LXC, ARM LXC, PVE, Addon, VM, DEV, Privileged 같은 유형 라벨과 함께 제공됨
  • Proxmox & Virtualization 범주의 예시는 다음과 같음
    • PVE Disk Health Tool: 물리 디스크 상태를 보고하고 필요 시 smartmontools와 nvme-cli를 설치함
    • PVE LXC Execute: Proxmox VE 노드의 하나 이상 LXC 컨테이너 안에서 사용자 지정 명령을 실행함
    • PVE Startup Dependency Check: VM 또는 LXC 시작 전 필요한 의존성과 참조 스토리지 가용성을 확인함
    • CronMaster: 웹 UI, 실시간 로그, 인증을 제공하는 셀프호스팅 cron 작업 스케줄러
    • All Templates: 여러 무료 LXC 템플릿 중 하나를 생성하는 스크립트

프로젝트와 안전 안내

  • 프로젝트는 GitHub와 Discord를 통해 연결됨
  • 사이트 하단에는 프로젝트가 커뮤니티에 의해 만들어졌고 MIT 라이선스의 오픈소스라고 표시됨
  • 복제 또는 유사 웹사이트가 있을 수 있으므로 공식 사이트인지 항상 확인해야 함
  • 시스템에서 실행하기 전에 모든 스크립트 소스를 철저히 검토해야 함

함께 보면 좋은 글 β

GN⁺   [-]
Hacker News 의견들

  • 제출자와 함께, tteck이 호스피스에 들어간다는 안타까운 소식을 전한 뒤 이 프로젝트 유지보수를 돕기로 자원한 메인테이너 팀에 합류해 있음
    팀원들은 모두 tteck의 유산을 이어가려는 의지가 강하고 열정적임
    투명하게 진행하고 있으며, 질문이 있으면 기꺼이 답하겠음
    (1) https://news.ycombinator.com/item?id=42016605

    • 정말 안타까운 소식임
      최근에야 홈랩/셀프호스팅을 시작했는데, 컨테이너 대부분을 tteck 스크립트로 설정했음

  • 몇 년째 Proxmox VE를 쓰고 있고, 대부분의 서비스를 하나의 VM 안에서 Docker 컨테이너로 돌리고 있었음
    개별 서비스와 백업 작업을 Proxmox 인터페이스에서 제어하고 싶어서 늘 아쉬웠는데, 이 스크립트들을 보고 Caddy와 WireGuard 몇 개를 LXC 컨테이너로 옮겼고 매우 쉽게 처리돼서 인상적이었음
    이 스크립트를 만든 모든 분들 덕분에 첫인상이 아주 좋았음

    • 조심해야 함. 나도 같은 생각을 했지만, Docker 컨테이너는 LXC 스크립트보다 주요 버전 간 업데이트와 자동 업그레이드에서 이점이 있음
      보통 소프트웨어를 만든 개발자가 컨테이너도 만들기 때문에 지원되는 환경이고, 애플리케이션과 향후 업그레이드를 잘 아는 만큼 각 버전에 맞게 환경이 올바르게 구성되어 있음
      목표를 달성하려면 앱마다 좋아하는 Linux 배포판을 올린 LXC + Docker + 앱 컨테이너 조합을 권함. 같은 효과를 얻으면서 위 장점도 유지할 수 있음

  • 약간 곁가지지만, Terraform으로 libvirt와 Unraid를 관리하려다 문제를 계속 만나서 거의 포기하고 VM을 수동으로 관리하려는 중임
    Proxmox의 가상화 기술은 무엇인지 궁금함
    이런 도구를 Terraform, SaltStack, Ansible 같은 것 대신 쓰는 장점도 궁금함

    • Proxmox가 ZFS를 사용해서 스냅샷이 빠르고, 백업 시스템도 매우 좋다는 점도 언급할 만함
      셀프호스팅 애플리케이션을 “양떼”처럼 다루고 싶다면 Terraform, Kubernetes 등이 더 나은 선택임
      하지만 문제가 생겼을 때 백업이나 스냅샷에서 수동 복구해도 괜찮거나, 클러스터가 있을 때 LXC 컨테이너가 다른 하드웨어로 자동 이동되길 원한다면 Proxmox가 맞음. 실제 가정 환경에서는 “반려동물”을 유지하는 시간이 “농장”을 운영하는 시간과 비슷하거나 더 적게 듦
      (1) 뉴질랜드에서 쓰는 말장난임
    • Proxmox는 호스트와 그 위의 자원 관리를 더 중시함. 호스트 간 VM 라이브 마이그레이션, 일부 고가용성, 장애 조치 지원이 포함됨
      원한다면 Proxmox와 함께 Terraform 같은 도구로 VM 내부 설정을 관리할 수도 있을 것임
    • Proxmox는 가상화에 KVM, 컨테이너에 Linux Containers(LXC) 를 사용함
      코드형 인프라 배포라면 Terraform이나 Ansible 같은 것이 더 말이 된다는 데 동의함. Proxmox를 홈랩에 쓰는 사람들은 대체로 수동 관리를 선호하고 코드형 인프라 구현은 신경 쓰지 않는 편임
      업무에서는 재현 가능한 환경과 코드형 인프라를 굳게 믿고 있음. 실제로 Vagrant, libvirt, KVM 조합으로 로컬 클러스터를 빠르게 띄워 테스트와 개발에 쓰고 있고 꽤 잘 동작함. 다만 내 홈랩은 Terraform/Ansible을 설정할 만큼 복잡하지 않음. 서버가 망가지면 생각이 달라질 수도 있겠지만
    • Terraform용 Proxmox 공급자로 절충할 수 있음[1]
      흐름은 Terraform으로 VM을 프로비저닝하고, Ansible 같은 것으로 VM을 설정/유지하는 방식임
      LXC를 대상으로 삼고 싶다면 이 공급자로 LXC도 예약할 수 있음
      [1]: https://github.com/Telmate/terraform-provider-proxmox

  • 첫 Proxmox 장비를 구성하려고 알아보는 입장에서 보면, 아주 기본적이고 흔한 구성을 하고 싶었음
    모뎀 > Proxmox 장비 > OPNsense VM > 온보드 10Gb NIC를 통한 물리 Wi-Fi 라우터 + OMV 같은 내부 네트워크 VM 구조임. 목표는 OPNsense로 전체 네트워크 필터를 추가하고, 내부 네트워크에서 미디어 서버와 백업 등에 접근하게 하는 것임
    그런데 OPNsense 스크립트는 보이지 않고, OMV 스크립트는 LXC 컨테이너가 아니라 VM이어야 해서 사실상 권장되지 않는 형태이며, VM끼리 통신하게 하는 접착 스크립트도 보이지 않음. 이 부분은 Proxmox 설정에서 중요하니, 단순한 홈 서버 기본 구성 스크립트를 개선하거나 추가할 여지가 있어 보임

    • 그건 기본적이고 흔한 구성이 아님. 나에게는 그렇지만, 아마 당신에게도 아닐 수 있고 대부분에게는 확실히 아님
      라우터와 방화벽을 가상화하려는 건 괜찮음. pfSense 방화벽/라우터를 VM과 물리 장비로 약 200대 배포해 봤고 OPNSense도 비슷하니 도울 수 있을 것 같음
      최소한 물리 인터페이스 두 개가 필요함. 하나로도 가능하긴 하지만 뭘 하는지 정확히 알아야 함. “WAN”과 “LAN”이 필요함. OPNSense는 아직 FreeBSD 기반일 테니, 당연히 Linux LXC 컨테이너에서는 실행되지 않음
      마지막 문단은 다소 혼란스러움. “접착 스크립트”가 무엇을 뜻하는지 모르겠음. VM은 네트워크로 통신함
      가상화를 제대로 이해하려면 몇 가지 실험을 해보고 그다음 진행하는 편을 권함. 구체적인 문제가 있으면 Proxmox 포럼에 오면 도와주겠지만, 결국 제대로 뛰어들거나 아니거나 둘 중 하나임
    • Proxmox를 쓰고 있고 VLAN도 설정해 둠
      라우터에서 Proxmox 장비로 가는 포트는 들어오고 나가는 트래픽을 분리하는 태그된 패킷용으로 설정해 둠
      그다음 VM과 컨테이너는 하나 이상의 네트워크에 “살도록” 쉽게 설정됨
      내 경우 라우터의 방화벽 규칙이 VLAN 사이에서 어떤 트래픽을 중계할지 결정함
      OPNSense를 컨테이너나 VM으로 띄워도 같은 식으로 VLAN 간 트래픽을 선택적으로 넘기게 구성할 수 있을 것 같음
    • OPNSense 스크립트가 없었던 건, 설정 실수 하나로 Proxmox 인스턴스가 인터넷에 노출될 수 있기 때문이었던 것 같음
      고급 사용자는 ISO로 VM을 띄우는 게 충분히 쉬움. 최근 OPNSense 스크립트 요청도 있었음
      OMV에 대해서는 동의함. 그대로 쓸 수는 있지만, 보통 사람들이 원하는 사용 방식은 아님. 며칠 전에 스크립트에 주석이 추가됐음
      VM끼리 통신하게 하는 접착 스크립트가 없다고 했는데, 기술적으로는 Tailscale을 통해 서로 통신하게 돕는 Tailscale 스크립트가 있음 :)
      이 스크립트들은 자체 완결적인 LXC 컨테이너를 설정하도록 설계되어 있음. 우리만의 Kubernetes를 만들려는 건 피하고 있음
    • Proxmox에서 OPNSense VM을 쓰고 있고 NIC도 여러 개 있음. 그중 하나는 광 회선 ONT 전용임
      외부 Wi-Fi 메시도 사용 중임
      다른 VM도 몇 개 있음. 과거 호환성 때문에 SATA 카드 패스스루로 Docker를 호스팅하는 unRaid VM, Home Assistant OS용 VM, 그리고 많은 LXC가 있음. 아주 훌륭하게 동작함
    • “VM끼리 통신하게 하는 접착 스크립트”가 무슨 뜻인지 모르겠음
      그냥 다른 컴퓨터처럼 네트워크를 쓰면 되는 것 아닌가?
      VM끼리 통신하게 하려고 특별한 설정을 한 적은 없음

  • Docker LXC와 Home Assistant VM은 꼭 살펴볼 생각임
    지금까지는 Proxmox의 VM 안에서 Docker를 성공적으로 쓰고 있었지만, 어쩌면 효율을 더 짜낼 수 있을지도 모름

    • Proxmox에서 HAOS를 VM으로 돌리면 잘 동작함
      tteck의 헬퍼 스크립트 몇 개로 MQTT와 zigbee2mqtt LXC 컨테이너를 설정하고, USB Zigbee 장치를 패스스루해서 썼음
    • 이 두 프로젝트용 스크립트는 매우 잘 동작함
      Home Assistant는 LXC나 Docker보다 HAOS VM을 추천함

  • 홈랩에 Kubernetes 대신 Proxmox를 돌리기로 했는데, 어느 정도 후회하고 있음
    LXC는 훌륭하지만 LXC나 QEMU VM에만 묶이는 것이 내 모든 요구에 맞지는 않음. Kubernetes였다면 Kata 같은 프로젝트로 Firecracker 하이퍼바이저나 유니커널 같은 가벼운 VM 지원을 추가할 수 있었을 텐데, Proxmox는 확장성이 부족함
    또한 Kubernetes 같은 검증된 파드 관리자만큼 자동화나 재현 가능한 빌드에 맞지 않음. 내가 찾은 바로는 Terraform 지원도 없어서 전체 디스크 백업과 Chef/Ansible/Puppet류 도구에 기대야 하는데, 다시 배우는 데 투자하고 싶지 않음
    그래도 자원 관리와 패스스루 모델은 매우 좋고, 설정과 유지보수가 쉬우며 제어판도 괜찮음

    • 확실히 배포 모델이 다름. 단점은 있지만 나는 좋아함
      다만 커뮤니티 Terraform 모듈이 있음: https://registry.terraform.io/providers/Telmate/proxmox/late...
      직접 써본 적은 없고 보통 Ansible을 선택함
      쉽게 설치되는 ZFS 때문에 다른 걸 시도하도록 스스로 설득하기가 어렵기도 함. Kubernetes를 가지고 놀고 싶으면 VM을 하나나 여러 개 띄우면 됨
    • 나는 꽤 철저하게 NixOS에 빠졌음
      한동안 여러 단일 보드 컴퓨터로 Docker Swarm을 돌렸고, 그다음 Kubernetes, Ubuntu + Cockpit을 돌리는 큰 서버, Proxmox를 거쳐 결국 NixOS에 정착함
      NixOS는 필요하면 컨테이너 지원도 괜찮지만, 선언적 특성 덕분에 컨테이너를 거의 쓰지 않게 됨. 무언가를 “제거”하는 것도 보통 설정 파일에서 빼고 다시 빌드하면 끝임. 메모리 관리 같은 걸 위해 cgroup스러운 작업을 하는 것도 어렵지 않음
      NixOS의 nginx DSL도 훌륭하다고 생각함. 직접 스크립트를 쓰는 대신 프록시 설정과 Let’s Encrypt를 설정 환경이 직접, 그리고 올바르게 관리해 주는 게 정말 좋음
      분산 NixOS 관련 도구가 있는지는 모르겠지만, Flakes 위에 멋진 것이 만들어질 수 있을 것 같음
      내 홈랩은 지금이 가장 단순하고 만족도도 가장 높음
    • 이 Terraform 공급자[1]와 Talos[2] 배포판을 함께 써서 Kubernetes 클러스터를 배포해 봤음
      Proxmox에서 제공되는 API가 완전하지 않다는 데는 동의하지만, 내 필요에는 충분함
      폐기 직전의 SFF 장비 네 대로 클러스터를 돌리고, LVM 스냅샷을 직접 만든 TrueNAS 저장소에 백업하고 있는데, 이 모든 구성이 마음에 듦
      [1] https://github.com/Telmate/terraform-provider-proxmox
      [2] https://factory.talos.dev/
    • Proxmox를 쓴다고 Kubernetes를 못 쓰는 건 아님
      Proxmox에서 VM을 만들고 그 위에 Kubernetes를 설치한 뒤 애플리케이션 워크로드를 Kubernetes에서 돌리면 됨
      Proxmox VM은 자동화가 더 어려우므로 “가축이 아니라 반려동물”처럼 다뤄야 하지만, 베어메탈에서 Kubernetes 호스트를 관리할 때도 마찬가지임. 다만 Proxmox 위 VM은 전체 VM 백업과 마이그레이션을 Proxmox로 할 수 있으니, Proxmox와 Kubernetes의 장점을 모두 얻을 수 있음
    • 기술마다 맞는 접근 방식과 용도가 다름
      Proxmox에서는 pve 명령줄 유틸리티로 VM을 만들거나 수정하는 것이 비교적 간단함
      그래도 이 글의 출발점은 관리를 더 쉽고 유지 가능하게 해 주는 유용한 스크립트들이 많고, 창립자가 물러나야 하는 상황에서 그 도움에 대한 고마움이 있다는 데 있음

  • 단순 KVM에는 없고 Proxmox에는 있는 기능이 무엇인가? 그냥 웹 인터페이스뿐인가?

    • 당장 떠오르는 것만 해도 클러스터링, 마이그레이션, 고가용성, 백업, Ceph 통합, 최근의 가상 네트워크, VM뿐 아니라 컨테이너 지원이 있음
      웹 인터페이스도 선택 사항임. 더 자세한 내용은 Proxmox 웹페이지를 보는 게 좋음
    • KVM은 커널 쪽 구성요소일 뿐이고, 그 자체로 완전한 가상 머신 관리자가 아님. 항상 사용자 공간 애플리케이션이 필요함
      Firecracker, QEMU, Cloud-Hypervisor가 KVM 위에 만들어진 가상 머신 관리자들임
      QEMU가 KVM을 쓰는 일반적인 방식이지만 QEMU를 직접 실행하는 건 꽤 번거로움. 그래서 QEMU를 감싸는 libvirt나 Proxmox 같은 도구를 쓰게 됨

  • 훌륭한 커뮤니티임. 이미 스크립트 몇 개를 써 봤고, Pi-hole과 Paperless LXC 컨테이너를 돌리고 있음
    Appflowy도 기대 중임

  • 안타깝게도 Proxmox는 웹사이트 첫 문단에 “Enterprise”라는 단어를 쓰면서도 아직까지 전체 디스크 암호화를 기본 지원하지 않음
    물론 직접 암호화된 Debian에 설치하는 방법은 있지만, 중요한 기능을 놓치게 되고 스스로 감당해야 함. 결국 ZFS가 전체 디스크 암호화를 일급 기능으로 다루지 않는 데서 비롯됨
    매우 아쉬운 상황임

답변달기
GeekNews BeeBS 게시판 오픈! 자유로운 이야기와 소소한 일상을 함께 나눠보세요.