From 82caac3872839d6956b1908f8ffd6d325dda42fb Mon Sep 17 00:00:00 2001 From: jeon Date: Thu, 18 Jun 2026 09:30:38 +0900 Subject: [PATCH] =?UTF-8?q?docs:=20Gitea=20=EC=A0=91=EC=86=8D=C2=B7?= =?UTF-8?q?=ED=98=91=EC=97=85=C2=B7=EC=9E=91=EC=97=85=ED=99=98=EA=B2=BD=20?= =?UTF-8?q?=EA=B0=80=EC=9D=B4=EB=93=9C=20=EC=B6=94=EA=B0=80?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-Authored-By: Claude Opus 4.8 (1M context) --- doc/Gitea_저장소_접속_및_협업_가이드.md | 115 ++++++++++++++++++++++++ 1 file changed, 115 insertions(+) create mode 100644 doc/Gitea_저장소_접속_및_협업_가이드.md diff --git a/doc/Gitea_저장소_접속_및_협업_가이드.md b/doc/Gitea_저장소_접속_및_협업_가이드.md new file mode 100644 index 0000000..8f09ef5 --- /dev/null +++ b/doc/Gitea_저장소_접속_및_협업_가이드.md @@ -0,0 +1,115 @@ +# HECO2 Gitea 저장소 — 접속 · 협업 · 작업환경 가이드 + +HERV 통합 소스를 사내 Gitea로 관리하고 인터넷에서 접속·협업하기 위한 안내 문서. + +> ⚠️ 비밀번호·토큰 등 민감정보는 이 문서에 적지 않습니다. 각자 안전하게 보관하세요. + +--- + +## 1. 기본 정보 + +| 항목 | 내용 | +|---|---| +| 웹 주소 | https://gitea.himpelai.com | +| 저장소 | https://gitea.himpelai.com/jeon/HECO2 | +| Clone 주소(HTTPS) | `https://gitea.himpelai.com/jeon/HECO2.git` | +| 접속 | 사내/외부(인터넷)·휴대폰 모두 위 주소로 동일하게 접속 | + +회원가입은 보안상 막혀 있습니다. 계정은 **관리자(jeon)가 생성**해 전달합니다. + +--- + +## 2. 서버 구성 (운영자 참고) + +``` +인터넷 + │ https://gitea.himpelai.com + ▼ +가비아 DNS gitea.himpelai.com ─(CNAME)→ himpelai-gitea.duckdns.org ─(DDNS)→ 현재 공인IP(유동) + ▼ +TP-Link 공유기 외부 80/443 → 192.168.0.129 + ▼ +이 PC : Caddy(80/443, 자동 HTTPS / Let's Encrypt) + ▼ +Gitea (localhost:3000) +``` + +- **설치 위치**: `D:\GITEA` (설정 `D:\GITEA\custom\conf\app.ini`, RUN_USER=himpel) +- **HTTPS**: Caddy가 Let's Encrypt 인증서 자동 발급·갱신 (`D:\GITEA\Caddyfile`) +- **유동 IP 대응**: DuckDNS가 5분마다 현재 IP 추적 (`himpelai-gitea.duckdns.org`) +- **DNS**: `himpelai.com`은 가비아 관리, `gitea` 서브도메인만 CNAME 추가(메일 등 영향 없음) + +### 자동시작 (himpel 로그온 시) +재부팅 후 **himpel 계정으로 로그인하면** 아래가 자동 기동됨: + +| 예약작업 | 역할 | 실행계정 | +|---|---|---| +| `Gitea-Web-Autostart` | Gitea 서버 (`D:\GITEA\start-gitea.ps1`) | himpel(로그온) | +| `Caddy-Gitea-Autostart` | HTTPS 프록시 (`D:\GITEA\start-caddy.ps1`) | himpel(로그온) | +| `DuckDNS-Gitea-Update` | 유동IP 추적 (`D:\GITEA\duckdns-update.ps1`) | SYSTEM(5분) | + +> **재부팅 후 사이트 접속이 안 될 때**: 서버 PC가 **himpel로 로그인됐는지** 먼저 확인. 로그인 전에는 Gitea·Caddy가 안 떠서 502가 납니다. + +--- + +## 3. 외부 인원 등록 (관리자 jeon) + +### 3-1. 계정 생성 (웹 관리자 화면) +1. `jeon`으로 로그인 → 우측 상단 **프로필 사진** → **「사이트 관리」** (또는 주소 `/-/admin`) +2. 왼쪽 **「사용자 계정」** → 오른쪽 위 **「사용자 계정 생성」** +3. 입력: **사용자 이름 / 이메일 주소 / 비밀번호**, ✅ **「처음 로그인할 때 비밀번호 변경」** 체크 +4. **「사용자 계정 생성」** → 인원수만큼 반복 + +> 「사이트 관리」 메뉴가 안 보이면 그 계정은 관리자가 아님. + +### 3-2. 저장소 권한 부여 +1. `https://gitea.himpelai.com/jeon/HECO2` → 상단 **「설정」** +2. 왼쪽 **「공동 작업자」** → 사용자 이름 입력 → **「공동 작업자 추가」** +3. 권한 선택: **「쓰기」**(push 가능) / **「읽기」**(보기만) + +> 인원·저장소가 늘면 개인 소유 대신 **Organization(조직)**으로 묶어 관리 권장. + +--- + +## 4. 다른 컴퓨터에서 작업환경 구성 (VS Code + Claude Code) + +> Gitea 계정과 Claude(Anthropic) 계정은 별개입니다. + +### 4-1. Git 설치 +- https://git-scm.com/download/win (기본 옵션 설치) + +### 4-2. 저장소 클론 +```powershell +git clone https://gitea.himpelai.com/jeon/HECO2.git +``` +- 아이디/비밀번호 → **Gitea 계정**으로 입력 +- 권장: 비밀번호 대신 **액세스 토큰** 사용 + - Gitea 로그인 → 프로필 → **설정 → 응용 프로그램 → 토큰 생성** → 토큰을 비밀번호 자리에 입력 + +### 4-3. VS Code 설치 +- https://code.visualstudio.com → 설치 → **파일 → 폴더 열기** → 클론한 `HECO2` 폴더 + +### 4-4. Claude Code 설치 +- VS Code 왼쪽 **확장(Extensions)** (`Ctrl+Shift+X`) → **`Claude Code`** 검색 → Anthropic 확장 설치 +- 안내에 따라 **Anthropic 계정 로그인** (Claude 구독 또는 API 키) +- (대안) 터미널: Node.js 설치 후 `npm install -g @anthropic-ai/claude-code` → 폴더에서 `claude` + +### 4-5. 작업 & 반영 +```powershell +git add . +git commit -m "작업 내용" +git push +``` +→ `https://gitea.himpelai.com/jeon/HECO2` 에 반영 + +--- + +## 5. 자주 쓰는 git 명령 +```powershell +git clone https://gitea.himpelai.com/jeon/HECO2.git # 처음 받기 +git pull # 최신 내용 받기 (작업 전 권장) +git add . # 변경분 담기 +git commit -m "메시지" +git push # 서버에 올리기 +git status # 현재 상태 확인 +```