모든 서비스를 한 화면에 모으고, 각 서비스의 상태와 주요 수치를 위젯으로 보여준다.
http://192.168.0.240:3100/volume1/docker/homepage/config/ (윈도우에서 S:\docker\homepage\config\)services.yaml — 서비스 타일bookmarks.yaml — 하단 북마크 줄widgets.yaml — 상단 정보 바 (검색, 시스템 자원, 날씨)settings.yaml — 레이아웃, 테마, 그룹 배치docker.yaml — 도커 서버 연결 (nas)파일을 저장하면 자동으로 다시 읽는다. 안 되면:
sudo /usr/local/bin/docker restart homepage
용도별로 8개 그룹으로 나눠 두었다.
- 그룹명:
- 서비스명:
href: https://주소
description: 한 줄 설명
icon: 아이콘이름
server: nas # 컨테이너 상태·자원 표시
container: 컨테이너이름
siteMonitor: http://내부주소 # 상태 표시등
widget:
type: 위젯종류
url: http://내부주소
key: {{HOMEPAGE_VAR_XXX}}
widget: 하위 항목이 한 단계 더 들여써져 있어야 한다.
같은 레벨에 두면 오류 없이 조용히 위젯이 동작하지 않는다.
# ❌ 위젯이 무시된다
widget:
type: npm
url: ...
# ✅
widget:
type: npm
url: ...
실제로 DSM 과 Nginx Proxy Manager 가 이 상태여서 그 두 타일만 수치가 비어 있었다.
{{HOMEPAGE_VAR_XXX}} 형태로 쓰고 실제 값은 컨테이너 환경변수에 둔다.
- HOMEPAGE_VAR_NPM_PW=...
- HOMEPAGE_VAR_JELLYFIN_KEY=...
⚠️ 현재 Memos 토큰과 Paperless API 키는 파일에 평문으로 들어 있다.
이 설정 폴더가 S: 드라이브로 공유되고 백업본이 여기저기 복사되므로,
환경변수 방식으로 옮기는 것이 좋다.
Synology DSM 위젯은 아이디/비밀번호만 지원하고 2단계 인증을 통과하지 못한다.
API 오류: Authentication failed. 2FA enabled.
위젯을 쓰려면 2FA 없는 관리자 계정이 필요한데, DSM 관리 포트가 외부에 열려 있는 상태에서
그런 계정을 만드는 것은 위험하다. 위젯을 제거하고 링크와 상태등만 남겼다.
같은 정보는 Beszel(자원)과 Scrutiny(디스크)에서 더 자세히 볼 수 있다.
server: nas + container: 이름 을 넣으면 컨테이너 상태가 함께 표시된다/api/, Vaultwarden 은 /alive)