Git 서버 사용 가이드 (처음 사용자)

이 문서는 PH3 Git 서버를 처음 사용하는 사용자를 위한 최소 사용 가이드입니다.
아래 순서대로 진행하면 바로 프로젝트 관리를 시작할 수 있습니다.

1. Git 설치

Windows: Git Bash 설치
macOS / Linux: 기본 Git 사용

설치 확인:

git --version

2. 최초 1회 사용자 정보 설정 (PC마다 1번)

git config --global user.name "이름"
git config --global user.email "이메일"

3. SSH 키 생성 (최초 1회)

ssh-keygen -t ed25519

엔터를 계속 누르면 기본 경로로 생성됩니다.

공개키 확인:

cat ~/.ssh/id_ed25519.pub

출력된 내용을 복사해서
Gitea 웹 → 사용자 설정 → SSH Keys 에 등록하세요.

4. SSH 연결 테스트

ssh -p 2222 git@git.phized3lit.duckdns.org

아래 메시지가 나오면 정상입니다.

Welcome to Gitea

5. 새 프로젝트를 서버에 올리기 (처음 1회)

cd 프로젝트폴더
git init
git add .
git commit -m "initial commit"
git branch -M main
git remote add origin ssh://git@git.phized3lit.duckdns.org:2222/아이디/리포지토리명.git
git push -u origin main

6. 기존 프로젝트 내려받기

git clone ssh://git@git.phized3lit.duckdns.org:2222/아이디/리포지토리명.git

7. 평소 작업 방법

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

8. 서버 최신 내용 받기

git pull

9. 대용량 파일 사용 (선택)

git lfs install
git lfs track "*.zip"
git add .gitattributes
git add 큰파일.zip
git commit -m "add large file"
git push

서버 정보

Git 서버 주소: git.phized3lit.duckdns.org
SSH 포트: 2222
웹 접속 주소: https://git.phized3lit.duckdns.org

요약

최초에는 SSH 키 등록만 하면 끝
이후에는 add → commit → push만 반복
여러 PC에서도 동일하게 사용 가능
대용량 파일은 Git LFS 사용