git 서버 — 내 코드 저장소를 이 기기에
나눔OS 가 git 저장소를 맡아 둡니다. 다른 컴퓨터의 git 이 이 기기로 올리고(push) 받아 갑니다(clone, fetch).
무엇인가
코드를 넣어 두는 금고라고 생각하면 됩니다. 여러 컴퓨터에서 일한 코드를 한 곳(이 기기)에 모으고, 누가 무엇을 언제 바꿨는지 이력이 통째로 남습니다. 이 기기의 gitd 프로그램이 문을 지키고, 이름과 비밀번호가 맞는 사람만 들어옵니다.
지금 할 일: 아래 「어떻게 쓰나」의 네 단계를 한 번 따라 하면 다른 컴퓨터에서 git clone 이 됩니다.
어떻게 쓰나
1. 저장소 만들기
터미널에서:
2. 사용자 만들기
비밀번호를 묻습니다(8자 이상, 화면에 보이지 않음). 권한은 셋 중 하나입니다.
| 권한 | 할 수 있는 것 |
|---|---|
read | 받기(clone, fetch)만 |
write | 받기 + 올리기. 가지를 앞으로 잇는 올리기와 새 가지·태그, 가지 지우기 |
force | write + 이력을 바꾸는 강제 올리기(git push --force)와 있는 태그 옮기기 |
사용자를 빼려면 권한 자리에 - 를 씁니다. 파일에는 비밀번호 대신 Argon2id 지문만 남습니다.
3. 켜기 (서비스)
4. 다른 컴퓨터에서
git clone http://mina@이기기주소/myproject.git
git push origin main
주소는 net status 의 ip= 입니다. 비밀번호는 git 이 물어봅니다.
5. SSH 로 (열쇠로 들어오기)
비밀번호 대신 SSH 열쇠로도 됩니다. 이 기기의 sshd 가 켜져 있어야 합니다(「SSH」 장, 서비스로 늘 켜 둘 수 있음).
- 내 열쇠(
ssh-authorize로 넣은 주인 열쇠)는 모든 권한입니다:git clone ssh://zeus@이기기주소/myproject - git 전용 열쇠: 남에게 줄 열쇠는 git 만 쓰게 따로 넣습니다. 그 열쇠로는 셸도, 다른 명령도 안 됩니다.
권한은 위 표와 같습니다(read · write · force, 빼기는 -). 새 열쇠는 다음 접속부터 바로 통합니다.
6. 웹에서 일하기 (포지)
브라우저로 http://이기기주소/ 를 열고 git 과 같은 이름·비밀번호로 로그인합니다. 저장소 목록이 나오고, 저장소를 누르면 파일·커밋·가지·태그가 보입니다(한글 파일 이름, 옛 EUC-KR 글 파일도 바르게 보임).
- 새 저장소: 목록의 단추(
write권한). - 합치기 요청: 가지를 올린 뒤 합치기 요청 › 새 합치기 요청 에서 보낼 가지와 받을 가지를 고릅니다. 쪽에 커밋·바뀐 줄·댓글·검사 결과가 보입니다. 합치기 는 받는 가지를 앞으로 감거나(fast-forward) 합치기 커밋을 만듭니다. 양쪽이 같은 줄을 다르게 고쳤으면 어떤 파일인지 알려 주고 아무것도 바꾸지 않습니다.
- 이슈: 제목·내용·라벨(
bug, ui)·댓글·닫기·다시 열기. 읽을 수 있는 사람은 누구나 엽니다. - 설정 › 보호: 보호된 가지에는
force사용자만 바로 올리고, 다른 사람은 합치기 요청으로 합칩니다. 강제 올리기·지우기는 안 됩니다. - 설정 › 웹훅: 올리기·합치기 뒤에 작은 JSON 알림을 내가 적은
http://주소로 보냅니다. 비밀값으로 서명합니다. - 내 이름(오른쪽 위): ssh 로 쓸 SSH 열쇠와 접근 토큰. 토큰은 비밀번호 대신 씁니다(
git clone http://나:토큰@이기기주소/app.git).read토큰은 읽기만 합니다.
언어는 브라우저를 따릅니다(한국어·영어). 위쪽 링크로 바꿉니다.
작동 원리
올리기 한 번은 이렇게 흐릅니다.
- git 이 바뀐 것을 한 덩어리(팩)로 보냅니다. gitd 는 이 덩어리를 바로 넣지 않고 대기실에 둡니다.
- 대기실에서 모든 조각을 풀어 지문을 다시 계산하고, 조각끼리의 차이(델타)를 모두 맞춰 보고, 커밋·트리·태그의 꼴을 검사합니다. 이미 있는 조각과 지문이 같으면 내용도 똑같아야 합니다.
- 새 가지 끝에서 이어지는 모든 조각이 있는지 확인합니다. 하나라도 빠지면 그 올리기는 받지 않습니다.
- 검사를 통과한 덩어리를 저장소로 옮기고, 마지막으로 가지 목록 파일을 통째로 바꿉니다. 그다음 저장이 디스크에 닿은 것을 확인하고서야 git 에게 「됐다」고 답합니다.
같은 저장소에 두 사람이 동시에 올리면 하나씩 차례로 들어가고, 같은 가지를 둘이 동시에 고치면 먼저 들어간 쪽만 받고 다른 쪽은 「먼저 받아 오라」는 답을 받습니다(가지가 엉키지 않음).
그래서 올리는 도중에 gitd 가 죽거나 전원이 나가도, 다시 켜면 가지는 올리기 전이거나 올린 뒤 둘 중 하나이고 저장소는 온전합니다. 가지가 바뀔 때마다 누가·언제·무엇에서 무엇으로 바꿨는지가 reflog 파일에 한 줄씩 남습니다. 강제 올리기로 덮인 옛 커밋도 정리(gc) 때 지우지 않습니다.
웹의 합치기는 책상에 같은 파일 세 장을 놓고 일하는 사람과 같습니다: 둘이 시작한 원본, 내 것, 상대 것. 한쪽만 고친 줄은 그쪽 것을, 양쪽이 똑같이 고친 줄은 한 번만, 양쪽이 다르게 고친 줄이 있으면 멈추고(충돌) 아무것도 쓰지 않습니다. 새 합치기 커밋과 가지 옮김은 올리기와 같은 순서로 저장됩니다.
아직 안 되는 것
- 얕은 복제(
git clone --depth) — 이 서버는 이력을 통째로만 줍니다. 요청하면 까닭을 적어 거절합니다. - 일부만 받기(
--filter), push 옵션, SHA-256 저장소. - SSH 로는 프로토콜 v0 로 주고받습니다(내용은 같음).
- 한 번의 올리기는 256 MiB 까지입니다(그보다 크면 나눠 올립니다). 팩 크기가 256 MiB 를 넘는 저장소는 나눔OS 에서 팩 하나로 정리(
gitd gc)할 수 없습니다. - 웹: 줄마다 누가 고쳤는지(blame), Markdown 꾸미기(README 는 글로 보임), 위키, 릴리스, 조직·저장소별 구성원(권한은 사용자마다, 모든 저장소에 같음), 웹에서 비밀번호 바꾸기(
gitd passwd)는 아직 없습니다. 웹훅은http://만. - 로그인 세션은 RAM 에 있습니다. 기기를 다시 켜면 다시 로그인합니다.
기술 자세히
- 포지(ZFORGE,
docs/contracts/ZFORGE.md): 세션(zf쿠키, HttpOnly, SameSite=Lax, TLS 뒤에서는-S로 Secure)은/tmp/gitd-UID/s-*, 모든 양식에 csrf 값, 다른 출처의 양식은 거절. 기록:저장소/f/N(이슈·합치기 요청),저장소/f/Nc(댓글),저장소/f/settings,저장소/f/status;뿌리/.tokens(토큰은 BLAKE2b 해시만),뿌리/.profiles,뿌리/.ssh-keys. 웹훅:gitd hooks프로세스가 대기열(/tmp/gitd-UID/hq-*)을X-Nanum-Signature: sha512=HMAC와 함께 보냄, 3번까지, 최근 전달은 설정에 보임. - 웹:
/목록,/이름/,/이름/tree/경로?r=가지,/이름/blob/…,/이름/raw/…,/이름/log,/이름/commit/ID. 모든 쪽에Content-Security-Policy: default-src 'none'(저장소 내용은 보이기만, 실행하지 않음). - 규약: git 의 smart HTTP. 받기는 protocol v2 와 v0(multi_ack_detailed, side-band-64k, ofs-delta, thin-pack, include-tag), 올리기는 report-status, atomic, delete-refs, side-band-64k, 얇은 팩(thin pack). 요청 몸은 Content-Length·chunked·gzip.
- 저장:
뿌리/저장소/아래HEAD,refs(가지 전부 한 파일),reflog,p/(팩 + 팩 색인 v2),o/(적은 조각은 낱개, 100개 미만 올리기). 파일 이름은 나눔OS 의 31바이트 이름 칸에 맞췄습니다. - 나눔OS 에서 대기실·잠금·상태 파일은
/tmp/gitd-UID(저장되지 않음)에 있고, 올리기 한 번에 저장은 한 번(sync)입니다. 홈은 통째로 한 번에 저장되므로 그 저장 안에서 조각·가지·reflog 가 함께 디스크에 닿습니다. - 로그인: HTTP Basic + Argon2id(19 MiB, 2회). 한 번 맞은 비밀번호는 gitd 가 도는 동안 메모리에서만 기억합니다. 1분에 10번 틀린 주소는 1분 동안 막힙니다.
- 점검: 비서의
os_check에 「git 서버」 줄(켜짐·요청·올리기·거절·마지막 오류)이 있습니다. 상태 파일/tmp/gitd-UID/state.
NanumOS 0.1.8349 · 2026-11-16