# Git 서버 사용 가이드 (최초 1회)

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

---

## 1. Git 설치

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

설치 확인:
```bash
git --version
```

---

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

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

---

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

```bash
ssh-keygen -t ed25519
```

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

공개키 확인:
```bash
cat ~/.ssh/id_ed25519.pub
```

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

---

## 4. SSH 연결 테스트

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

아래 메시지가 나오면 정상입니다.
```
Welcome to Gitea
```

---

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

```bash
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. 기존 프로젝트 내려받기

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

---

## 7. 평소 작업 방법

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

---

## 8. 서버 최신 내용 받기

```bash
git pull
```

---

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

```bash
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 사용