프로젝트 소개
Proxmox VE Helper-Scripts (Community Edition)는 Proxmox VE에서 자가 호스팅 서비스를 설치하고 구성하는 자동화 스크립트 커뮤니티 유지 컬렉션입니다. 패키지를 직접 찾고 구성 파일을 편집하는 대신, 사용자는 Proxmox 셸에 단일 명령어를 붙여넣고 몇 가지 프롬프트에 응답하면 실행 중인 컨테이너나 가상 머신을 얻게 됩니다.
이 프로젝트는 tteck의 원래 작업을 기반으로 한 커뮤니티 계승 프로젝트로, 소규모 핵심 팀과 외부 기여자들이 관리합니다. 스크립트는 MIT 라이선스로, 개인 및 상업적 목적으로 사용, 수정, 재배포가 가능합니다.
요구사항
- Proxmox VE 버전 8.4, 9.0, 9.1 또는 9.2 (Debian 기반 Proxmox 호스트).
- Proxmox 호스트의 루트 셸 접근 권한.
- 설치 중 인터넷 연결.
시작하기
1. Home Assistant, Nginx Proxy Manager, Jellyfin 등 설치할 서비스를 찾기 위해 프로젝트 웹사이트를 browse합니다.
2. 해당 스크립트 페이지에 표시된 원라인 설치 명령어를 복사합니다.
3. Proxmox 셸을 열고 명령어를 붙여넣습니다.
4. Default 또는 Advanced 설정 중 하나를 선택하고 프롬프트에 따릅니다.
각 스크립트 페이지는 컨테이너 구성, 기본 리소스 할당, 설치 후 참고 사항으로 문서화됩니다.
스크립트 동작 방식
Default 모드는 합리적인 CPU, RAM, 스토리지 기본값을 선택하고 최소한의 질문만 묻습니다. 대부분 설치는 5분 이내에 완료됩니다. Advanced 모드는 설치 전에 컨테이너 설정, 네트워킹, 스토리지 백엔드 및 애플리케이션 수준 구성을 모두 노출합니다. 설치 후 각 컨테이너에는 Proxmox 셸에서 접근 가능한 설치 후 도우미가 포함되어 있어 설치된 서비스 업데이트 적용, 구성 파일 수동 편집 없이 애플리케이션 설정 변경, 기본 문제 해결 및 로그 접근을 제공합니다.
컬렉션 범위
README에는 수백 개 서비스에 대한 coverage가 소개되며, 다음과 같은 카테고리로 분류됩니다: 홈 자동화 (Home Assistant, Zigbee2MQTT, ESPHome, Node-RED), 미디어 (Jellyfin, Plex, Radarr, Sonarr, Immich), 네트워킹 (AdGuard Home, Nginx Proxy Manager, Pi-hole, Traefik), 모니터링 (Grafana, Prometheus, Uptime Kuma, Netdata), 데이터베이스 (PostgreSQL, MariaDB, Redis, InfluxDB), 보안 (Vaultwarden, CrowdSec, Authentik), 개발 도구 (Gitea, Portainer, VS Code Server, n8n). 전체 목록은 프로젝트 웹사이트의 카테고리 페이지에 정기적으로 업데이트되어 공개됩니다.
기여하기
새 스크립트는 이 저장소에 직접 제출되지 않습니다. 먼저 별도의 ProxmoxVED 저장소에서 제출 및 테스트되며, 이 저장소에 새 스크립트를 추가하는 pull request는 닫힙니다. 기존 스크립트의 버그 수정 및 개선은 이 저장소에서 이루어지며, 기여 지침을 따라야 합니다. pull request당 하나의 초점 변경으로 제한되며, 스크립트가 설치하는 내용과 그외 비명확한 결정 사항은 해당 JSON 메타데이터 파일에 문서화해야 합니다. 버그는 issue tracker로 보고하고, 요청 및 질문은 discussions 또는 프로젝트 Discord로, 보안 취약점은 security policy를 통해 reports합니다.
지원 및 라이선스
프로젝트는 자원 봉사자들이 유지하며, 인프라 비용은 자체 부담합니다. README에 따르면 모든 기부금의 30%는 tteck에게 중요한 암 연구 및 Hospice care 단체에 전달됩니다. Proxmox는 Proxmox Server Solutions GmbH의 등록 상표이며, 코드는 MIT 라이선스에 따라 배포됩니다.
Comments
0 Rating appears after 10 ratings
Sign in to join the discussion.