NanumOS

git 서버 — 내 코드 저장소를 이 기기에

나눔OS 가 git 저장소를 맡아 둡니다. 다른 컴퓨터의 git 이 이 기기로 올리고(push) 받아 갑니다(clone, fetch).

무엇인가

코드를 넣어 두는 금고라고 생각하면 됩니다. 여러 컴퓨터에서 일한 코드를 한 곳(이 기기)에 모으고, 누가 무엇을 언제 바꿨는지 이력이 통째로 남습니다. 이 기기의 gitd 프로그램이 문을 지키고, 이름과 비밀번호가 맞는 사람만 들어옵니다.

지금 할 일: 아래 「어떻게 쓰나」의 네 단계를 한 번 따라 하면 다른 컴퓨터에서 git clone 이 됩니다.

어떻게 쓰나

1. 저장소 만들기

터미널에서:

2. 사용자 만들기

비밀번호를 묻습니다(8자 이상, 화면에 보이지 않음). 권한은 셋 중 하나입니다.

권한할 수 있는 것
read받기(clone, fetch)만
write받기 + 올리기. 가지를 앞으로 잇는 올리기와 새 가지·태그, 가지 지우기
forcewrite + 이력을 바꾸는 강제 올리기(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」 장, 서비스로 늘 켜 둘 수 있음).

권한은 위 표와 같습니다(read · write · force, 빼기는 -). 새 열쇠는 다음 접속부터 바로 통합니다.

6. 웹에서 일하기 (포지)

브라우저로 http://이기기주소/ 를 열고 git 과 같은 이름·비밀번호로 로그인합니다. 저장소 목록이 나오고, 저장소를 누르면 파일·커밋·가지·태그가 보입니다(한글 파일 이름, 옛 EUC-KR 글 파일도 바르게 보임).

언어는 브라우저를 따릅니다(한국어·영어). 위쪽 링크로 바꿉니다.

작동 원리

올리기 한 번은 이렇게 흐릅니다.

  1. git 이 바뀐 것을 한 덩어리(팩)로 보냅니다. gitd 는 이 덩어리를 바로 넣지 않고 대기실에 둡니다.
  2. 대기실에서 모든 조각을 풀어 지문을 다시 계산하고, 조각끼리의 차이(델타)를 모두 맞춰 보고, 커밋·트리·태그의 꼴을 검사합니다. 이미 있는 조각과 지문이 같으면 내용도 똑같아야 합니다.
  3. 새 가지 끝에서 이어지는 모든 조각이 있는지 확인합니다. 하나라도 빠지면 그 올리기는 받지 않습니다.
  4. 검사를 통과한 덩어리를 저장소로 옮기고, 마지막으로 가지 목록 파일을 통째로 바꿉니다. 그다음 저장이 디스크에 닿은 것을 확인하고서야 git 에게 「됐다」고 답합니다.

같은 저장소에 두 사람이 동시에 올리면 하나씩 차례로 들어가고, 같은 가지를 둘이 동시에 고치면 먼저 들어간 쪽만 받고 다른 쪽은 「먼저 받아 오라」는 답을 받습니다(가지가 엉키지 않음).

그래서 올리는 도중에 gitd 가 죽거나 전원이 나가도, 다시 켜면 가지는 올리기 전이거나 올린 뒤 둘 중 하나이고 저장소는 온전합니다. 가지가 바뀔 때마다 누가·언제·무엇에서 무엇으로 바꿨는지가 reflog 파일에 한 줄씩 남습니다. 강제 올리기로 덮인 옛 커밋도 정리(gc) 때 지우지 않습니다.

웹의 합치기는 책상에 같은 파일 세 장을 놓고 일하는 사람과 같습니다: 둘이 시작한 원본, 내 것, 상대 것. 한쪽만 고친 줄은 그쪽 것을, 양쪽이 똑같이 고친 줄은 한 번만, 양쪽이 다르게 고친 줄이 있으면 멈추고(충돌) 아무것도 쓰지 않습니다. 새 합치기 커밋과 가지 옮김은 올리기와 같은 순서로 저장됩니다.

아직 안 되는 것

기술 자세히
  • 포지(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