zcloud — 기기마다 같은 금고
우리 서버(상자 zcloud)를 거쳐 나눔OS·맥·리눅스·휴대폰이 같은 금고(zeus.kdbx) 를 씁니다. 서버는 KeePass 가 이미 주 비밀번호로 암호화한 파일만 받습니다 — 서버도, 중간의 누구도 내용을 읽지 못합니다.
나눔OS 에서
- 터미널에서
vault zcloud join 주소 기기이름— 기기 비밀번호를 (보이지 않게) 입력합니다. 서버가 확인해야 가입됩니다. - 처음이면
vault zcloud sync— 주 비밀번호를 넣으면 서버의 금고를 받아 엽니다. - 그다음은 저절로: 금고를 열 때 다른 기기에서 바뀐 것을 받고, 항목을 더하거나 고치거나 지우면 바로 올립니다.
vault zcloud status— 서버·기기 이름·마지막으로 맞춘 때와 결과.vault zcloud leave— 이 기기에서 빼기(금고는 그대로).
설정 화면 (설정 › zcloud)
명령 대신 화면으로도 됩니다. 설정 › zcloud 칸:
- 아직 가입하지 않았다면 서버 주소 · 기기 이름 · 기기 비밀번호(보이지 않게 입력)를 적고 가입. 서버가 확인해야 가입되고, 틀리면 아무것도 남지 않습니다. 비밀번호는 화면·기록에 나오지 않습니다.
- 가입하면 서버·기기 이름·마지막 맞춤(몇 분 전 · 성공/실패 · 추가·고침·삭제 수, 실패면 까닭)이 보입니다.
- 지금 맞추기 — 금고가 열려 있을 때만 됩니다(잠겨 있으면 금고 앱에서 먼저 여세요). 도는 동안 화면은 계속 그려지고 Esc 로 그만둘 수 있습니다.
- 떠나기 — 이 기기에서 빼기(금고는 그대로). 그러면 다시 가입 칸이 나옵니다.
금고 앱 아래 줄에는 가입한 기기에 한해 zcloud: 3분 전 맞춤 이 보입니다. 나눔OS 모바일은 가입할 것이 없습니다 — 금고 앱이 내 zcloud 의 금고를 찾아 마스터 암호만 한 번 묻습니다(앱 설명서 「금고」의 「모바일에서」). os_check(Zeus 앱의 점검)에는 「zcloud」 칸이 있습니다 — 가입 안 함 · 마지막 맞춤 N분 전(건강) · 24시간 넘음(주의) · 마지막 결과 실패(흠, 까닭) · 못 잼(?).
맥·리눅스에서
주 비밀번호는 매번 묻거나, 600 파일 KX_PW_FILE 에서 읽습니다.
윈도우에서
zcloud.exe (윈도우 7 이상 64비트, 명령 줄) — 맥·리눅스와 같은 join · sync · status · leave. 설정은 %USERPROFILE%\.config\zcloud 에 둡니다.
휴대폰·다른 KeePass 앱
KeePassium(아이폰)·KeePassDX(안드로이드)·KeePassXC·Strongbox 의 WebDAV 로 같은 주소·기기 이름·기기 비밀번호를 넣으면 같은 금고를 엽니다. 이 앱들도 저장할 때 서버 사본과 합칩니다.
부딪힐 때
두 기기가 같은 항목을 고치면 나중에 고친 쪽이 남고, 다른 쪽은 그 항목의 기록(History) 에 남습니다 — 잃는 것은 없습니다. 지운 항목은, 다른 기기에서 그 뒤에 고치지 않았으면 모든 기기에서 휴지통으로 갑니다. 기기 시계가 맞아야 합니다.
안전
기기 빼기
잃어버린 기기는 서버에서 계정을 지우면(관리자 device.sh revoke 기기) 그 자리에서 거절됩니다.
파일 — 사진·음악·영상·문서
- 연결: 터미널에서
vault zcloud files join http://NAS:8798/ 기기이름(금고에 이미 연결했으면 비번을 다시 묻지 않습니다). - 되찾기:
vault zcloud files trash로 지운 것,vault zcloud files versions /경로로 옛 판을 보고vault zcloud files restore <그 경로>로 되돌립니다. - 휴대폰: PhotoSync·Documents·FolderSync 같은 WebDAV 앱에 주소
http://NAS:8798/, 기기 이름, 비번 (자세한 차례는 docs/ZCLOUD.md §8).
NanumOS 0.1.8349 · 2026-11-16