jeon/HECO2

Files

T

jeon 82caac3872 docs: Gitea 접속·협업·작업환경 가이드 추가

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

2026-06-18 09:30:38 +09:00

4.5 KiB

Raw Blame History

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. 계정 생성 (웹 관리자 화면)

jeon으로 로그인 → 우측 상단 프로필 사진 → 「사이트 관리」 (또는 주소 /-/admin)
왼쪽 「사용자 계정」 → 오른쪽 위 「사용자 계정 생성」
입력: 사용자 이름 / 이메일 주소 / 비밀번호, ✅ 「처음 로그인할 때 비밀번호 변경」 체크
「사용자 계정 생성」 → 인원수만큼 반복

「사이트 관리」 메뉴가 안 보이면 그 계정은 관리자가 아님.

3-2. 저장소 권한 부여

https://gitea.himpelai.com/jeon/HECO2 → 상단 「설정」
왼쪽 「공동 작업자」 → 사용자 이름 입력 → 「공동 작업자 추가」
권한 선택: 「쓰기」(push 가능) / 「읽기」(보기만)

인원·저장소가 늘면 개인 소유 대신 **Organization(조직)**으로 묶어 관리 권장.

4. 다른 컴퓨터에서 작업환경 구성 (VS Code + Claude Code)

Gitea 계정과 Claude(Anthropic) 계정은 별개입니다.

4-1. Git 설치

https://git-scm.com/download/win (기본 옵션 설치)

4-2. 저장소 클론

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. 작업 & 반영

git add .
git commit -m "작업 내용"
git push

→ https://gitea.himpelai.com/jeon/HECO2 에 반영

5. 자주 쓰는 git 명령

git clone https://gitea.himpelai.com/jeon/HECO2.git   # 처음 받기
git pull            # 최신 내용 받기 (작업 전 권장)
git add .           # 변경분 담기
git commit -m "메시지"
git push            # 서버에 올리기
git status          # 현재 상태 확인

4.5 KiB Raw Blame History