깃허브 포크(Fork)는 다른 사람의 원격 저장소를 본인의 깃허브 계정으로 복제해 독립적인 개발 환경을 만드는 기능입니다. 원본 프로젝트에 직접적인 쓰기 권한이 없더라도 코드 수정이나 실험을 자유롭게 진행할 수 있도록 돕습니다.
개발 협업이나 오픈소스 기여 과정에서 포크는 안전한 코드 제안을 위한 표준적인 방식으로 널리 쓰입니다. 복사된 저장소는 전체 커밋 기록과 브랜치를 온전히 유지하므로 독립적인 테스트가 가능해집니다.
포크한 이후 로컬 환경과 연결하고 변경 사항을 다시 원본 저장소에 반영하는 흐름을 익혀두면 원활한 협업을 이어갈 수 있습니다. 본 가이드를 통해 기본적인 개념부터 동기화 절차까지 차근차근 확인할 수 있습니다.
- 포크는 원격 서버 상에서 계정 간 저장소를 복제하는 GitHub 플랫폼 고유 기능입니다.
- 수정한 코드는 풀리퀘스트를 통해 원본 저장소 관리자에게 병합을 요청할 수 있습니다.
- 원본 저장소의 최신 커밋을 유지하려면 upstream 원격 저장소를 등록해 동기화해야 합니다.
포크와 클론의 핵심 개념과 차이점
포크 클론 차이를 이해하는 것은 깃 워크플로의 출발점입니다. 클론(Clone)은 원격 서버에 있는 저장소를 본인의 개인 PC(로컬 환경)로 내려받는 깃 자체의 기본 명령어입니다. 반면 깃허브 포크는 깃 자체의 명령어가 아니라 원격 호스팅 서비스에서 제공하는 서버 간 복제 기능입니다.
클론을 수행하면 로컬 디렉터리에 작업 폴더가 생성되지만, 해당 원본 원격 저장소에 쓰기 권한이 없다면 수정 사항을 다시 온라인으로 푸시(Push)할 수 없습니다. 이때 포크를 활용하면 내 계정 소유의 원격 저장소가 생기므로 자유롭게 수정 사항을 푸시할 수 있는 권한을 얻게 됩니다.
| 구분 | 포크 (Fork) | 클론 (Clone) |
|---|---|---|
| 동작 위치 | GitHub 원격 서버 간 (계정 대 계정) | 원격 서버에서 로컬 컴퓨터로 복제 |
| 기능 주체 | 호스팅 플랫폼 고유 기능 (GitHub Docs 기준) | Git 표준 내장 명령어 (git clone) |
| 쓰기 권한 | 복제된 개인 저장소에 직접 푸시 가능 | 원본 저장소에 권한이 없으면 푸시 불가 |
저장소 포크 및 로컬 환경 설정
GitHub Docs 안내에 따르면, 포크 작업은 기여하려는 원본 프로젝트 웹 페이지의 우측 상단에 위치한 'Fork' 버튼을 누르는 것으로 시작합니다. 팝업 창에서 저장소 이름을 확인하고 생성을 승인하면 본인 계정 네임스페이스 아래에 새로운 복제본이 마련됩니다.
웹상에 저장소가 복제되었다면 터미널을 열고 본인의 포크 저장소 주소를 이용해 로컬 컴퓨터로 내려받아야 합니다. 아래와 같이 git clone [내-포크-저장소-URL] 명령어를 실행하면 로컬 폴더에 소스코드가 내려받아지며, 기본 원격 저장소 이름인 origin으로 자동 등록됩니다.
포크한 기본 브랜치(main 또는 master)에서 바로 코드를 수정하기보다는 git checkout -b feature-작업명 형태로 새로운 브랜치를 생성해 작업하면 추후 최신 코드 동기화 관리가 훨씬 간결해집니다.
깃허브 포크 동기화 및 원본 유지 방법
포크한 저장소는 시간이 흐를수록 원본 저장소의 변경 사항과 차이가 발생합니다. 최신 코드를 지속해서 반영하지 않으면 나중에 코드를 병합할 때 충돌이 일어날 가능성이 높아집니다. 원본 저장소의 최신 이력을 내 로컬 및 포크 저장소에 맞추는 과정을 깃허브 포크 동기화 작업이라고 부릅니다.
동기화를 진행하려면 먼저 원본 저장소를 가리키는 원격 주소를 등록해야 합니다. 일반적으로 관례상 원본 저장소의 이름을 upstream으로 지정하며, 터미널에서 다음 명령어로 연결 상태를 구성합니다.
git remote add upstream [원본-저장소-URL]
등록을 마친 뒤에는 git fetch upstream으로 최신 커밋을 가져오고, 로컬의 기본 브랜치로 이동한 뒤 git merge upstream/main 명령을 통해 최신 이력을 병합할 수 있습니다. GitHub 웹페이지 상단의 'Sync fork' 버튼을 클릭해 간편하게 갱신하는 것도 지원됩니다.
로컬의 기본 브랜치에서 직접 코드를 수정한 상태로 동기화 머지를 실행하면 병합 충돌이 발생할 수 있으므로, 기능 개발은 반드시 별도의 작업 브랜치에서 진행해야 합니다.
풀리퀘스트를 통한 오픈소스 기여 절차
로컬 브랜치에서 버그 수정이나 기능 추가를 완료했다면, 해당 내용을 본인의 포크 원격 저장소(origin)로 푸시합니다. 그 후 원본 저장소의 관리자에게 내 수정 코드를 프로젝트에 포함해 달라고 요청하는 풀리퀘스트(Pull Request)를 생성하게 됩니다.
GitHub 웹 저장소 상단에 표시되는 'Compare & pull request' 버튼을 누르면 원본 저장소와 내 저장소의 커밋 내역이 대조됩니다. 변경된 이유와 작업 내용을 명확하게 작성해 요청을 등록하면 관리자가 코드 리뷰를 진행합니다.
이와 같은 포크 기반 워크플로는 중앙 저장소에 대한 직접적인 접근 제어를 보장하면서도 전 세계 개발자의 참여를 유도할 수 있어 대부분의 오픈소스 기여 프로젝트에서 표준 구조로 채택되고 있습니다. 관리자가 검토 후 요청을 승인하면 내 작업이 원본 프로젝트에 온전히 병합됩니다.
자주 묻는 질문
Q. 포크한 저장소에 이슈(Issues)나 위키(Wiki)도 함께 복사되나요?
A. GitLab 및 GitHub Docs에 따르면 포크 시 저장소의 소스코드, 커밋 이력, 브랜치는 온전히 복제되지만 기존에 등록된 이슈 목록이나 풀리퀘스트, 위키 페이지 내용은 포함되지 않습니다. 순수한 코드베이스와 버전 관리 이력만 가져오는 방식으로 동작합니다.
Q. 원본 저장소가 비공개(Private)로 전환되거나 삭제되면 내 포크는 어떻게 되나요?
A. 원본 저장소의 공개 설정 변경이나 삭제 여부에 따라 포크 관계 정책이 다르게 적용됩니다. 공개 저장소가 삭제될 경우 일반적으로 포크는 독립 저장소로 분리되어 유지되지만, 비공개 저장소의 포크는 상위 프로젝트의 권한 정책에 직접적인 영향을 받으므로 프로젝트 관리 설정을 사전에 확인해야 합니다.
Q. 포크한 프로젝트를 원본에 기여하지 않고 별도 독립 프로젝트로 개발해도 되나요?
A. 원본 프로젝트의 오픈소스 라이선스 조건을 준수한다면 독립된 프로젝트로 발전시키는 것이 가능합니다. 오픈소스 라이선스에 따라 출처 명시나 동일 라이선스 적용 의무가 다를 수 있으므로 저장소에 포함된 LICENSE 파일을 먼저 점검하는 과정이 필요합니다.
포크 워크플로는 원본 코드베이스의 안정성을 훼손하지 않고 누구나 안전하게 개발에 참여할 수 있도록 돕는 유용한 체계입니다. 클론과의 차이점을 정확히 인지하고 원격 브랜치 설정법을 익히면 원활하게 협업을 수행할 수 있습니다.
지속적인 코드 기여를 위해서는 작업 전 최신 이력을 동기화하고 독립된 기능 브랜치에서 작업하는 습관을 들이는 것이 좋습니다. 안내된 절차를 차근차근 적용하면서 효율적인 버전 관리 환경을 구축해보시기 바랍니다.
이 글은 일반적인 정보 제공을 목적으로 작성되었습니다. 세부 기준과 적용 조건은 개정 여부나 개인의 상황에 따라 달라질 수 있으므로, 실제 결정을 내리기 전에 관련 기관의 최신 안내나 해당 분야 전문가의 확인을 받으시길 권장합니다.
