중국에서 git clone 쓰기

중국은 github도 안되고 위키도 안되고 ubuntu도 docker로 설치가 안되고
pip도 안되고 아나콘다도 가끔 안되거나 느리고

강한자만 살아남을 수 있는곳입니다...

그래서 중국은 보통 깃허브는 미러사이트를 사용하고 칭화대학에서 만든 TUNA라는 파이썬 미러를 사용하는데 이걸 어떻게 사용하는지 적어보려고 합니다.

예를들어 hloc을 설치하려고 하면 일반적으로 다음 명령어를 입력하면 됩니다.

# 필요한 의존성 설치
sudo apt update
sudo apt install -y python3-pip libgl1-mesa-glx libgtk2.0-dev

# 파이썬 패키지 설치
pip3 install numpy torch matplotlib tqdm pillow

# hloc 설치를 위한 pycolmap 설치, 이 과정은 COLMAP이 미리 설치되어 있어야 합니다.
pip3 install pycolmap

# hloc 저장소 클론
git clone https://github.com/cvg/Hierarchical-Localization.git hloc
cd hloc

# hloc 내의 파이썬 패키지 설치
pip3 install -e .

중국에서 사용하고 싶으면 다음 명령어를 입력해야합니다.

# 시스템 패키지 관리자의 패키지 목록 업데이트
sudo apt update

# 필요한 시스템 의존성 설치
sudo apt install -y python3-pip libgl1-mesa-glx libgtk2.0-dev

# pip의 기본 인덱스를 Tsinghua TUNA 미러로 변경
pip3 config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple

# 파이썬 패키지 설치
pip3 install numpy torch matplotlib tqdm pillow

# COLMAP이 미리 설치되어 있어야 합니다.
# pycolmap 설치
pip3 install pycolmap

# hloc 저장소 클론
git clone https://github.com/cvg/Hierarchical-Localization.git hloc
cd hloc

# hloc 내의 파이썬 패키지 설치
pip3 install -e .

pip3 config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple

칭화대 미러사이트

git clone https://gitclone.com/깃허브_주소

깃허브 미러 gitclone.com

근데 만약에 이것만으로 안되면
filezilla를 이용해서 직접 옮기시는게 정신건강에 좋습니다.

추가 2024 10.08 아나콘다, pip 명령어 등

중국 내에서 Anaconda 및 관련 패키지(예: pip, PyTorch 등)를 설치할 때 네트워크 제한으로 인해 기본 리포지토리에 접근하기 어려운 상황을 해결하기 위해, 명령어를 사용하여 Conda와 pip의 미러를 직접 설정하는 방법이 있습니다. 이를 통해 텍스트 편집기(nano 등)를 사용하지 않고도 손쉽게 미러 설정을 변경할 수 있습니다.

---

1. Conda 미러 설정

Conda의 기본 채널을 Tsinghua Tuna 미러로 변경하여 빠르고 안정적인 패키지 설치를 가능하게 합니다. 다음 명령어를 터미널에 직접 입력하여 설정을 변경하세요.

a. Conda 채널 추가 및 설정 변경

# 기본 채널 제거 (선택 사항)
conda config --remove-key channels

# Tsinghua Tuna 미러 채널 추가
conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/main/
conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/free/
conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/r/
conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud/conda-forge/
conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud/pytorch/
conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud/simpleitk/

# 채널 우선순위 설정
conda config --set channel_priority strict

# 채널 URL 표시 설정
conda config --set show_channel_urls yes

b. Conda 설정 확인

설정이 제대로 적용되었는지 확인하려면 다음 명령어를 사용하세요.

conda config --show channels

출력 결과에 Tsinghua Tuna 미러 URL이 포함되어 있어야 합니다.

c. Conda 업데이트

미러 설정을 적용한 후, Conda를 최신 버전으로 업데이트하여 설정이 정상적으로 반영되었는지 확인합니다.

conda update -n base -c defaults conda

---

2. pip 미러 설정

pip의 기본 인덱스를 Tsinghua Tuna 미러로 변경하여 빠른 패키지 설치를 가능하게 합니다. 다음 명령어를 터미널에 직접 입력하여 설정을 변경하세요.

a. pip 인덱스 URL 설정

pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple

b. pip 설정 확인

설정이 제대로 적용되었는지 확인하려면 다음 명령어를 사용하세요.

pip config get global.index-url

출력 결과가 https://pypi.tuna.tsinghua.edu.cn/simple이어야 합니다.

---

3. PyTorch 설치 시 Tsinghua Tuna 미러 사용

PyTorch는 Conda와 pip를 통해 설치할 수 있습니다. Tsinghua Tuna 미러를 사용하여 PyTorch를 설치하는 방법을 안내드립니다.

a. Conda를 통한 PyTorch 설치

conda install pytorch torchvision torchaudio cudatoolkit=12.4 -c https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud/pytorch/

b. pip을 통한 PyTorch 설치

만약 pip를 사용하여 설치하고자 한다면, 다음 명령어를 사용하세요.

pip install torch torchvision torchaudio --extra-index-url https://pypi.tuna.tsinghua.edu.cn/simple

참고: PyTorch의 경우 Conda를 사용하는 것이 더 안정적일 수 있습니다. 필요한 경우, PyTorch 공식 설치 페이지를 참고하여 적절한 설치 방법을 선택하세요.

---

4. 전체 Conda 및 pip 설정 확인

a. Conda 설정 확인

conda config --show

channels 섹션에 Tsinghua Tuna 미러 URL이 제대로 설정되어 있는지 확인합니다.

b. pip 설정 확인

pip config list

global.index-url이 https://pypi.tuna.tsinghua.edu.cn/simple로 설정되어 있는지 확인합니다.

---

5. 추가 유용한 팁

a. Conda 캐시 정리

패키지 설치 시 발생할 수 있는 문제를 방지하기 위해 Conda의 캐시를 정리합니다.

conda clean -i

b. SSL 인증서 문제 해결

만약 SSL 인증서 문제로 인해 설치가 실패할 경우, .condarc 파일에 다음 설정을 추가할 수 있습니다. 단, 이는 보안상 권장되지 않으므로 신뢰할 수 있는 네트워크 환경에서만 사용하세요.

conda config --set ssl_verify false

c. DNS 설정 변경

중국 내에서 더 빠른 DNS 서버를 사용하면 미러 사이트에 더 빠르게 접근할 수 있습니다. 예를 들어, 阿里云 (Aliyun)의 DNS 서버를 사용할 수 있습니다.

1. DNS 설정 파일 수정

   sudo nano /etc/resolv.conf

2. 아래 DNS 서버 추가

   nameserver 223.5.5.5
   nameserver 223.6.6.6

3. 저장 후 종료: Ctrl + O → Enter → Ctrl + X

주의: 일부 시스템에서는 resolv.conf가 자동으로 관리되므로, 네트워크 관리자와 상의 후 변경하는 것이 좋습니다.

---

깃허브는 그냥 안되네요. 해당 분기마다 새로운 미러사이트 찾아서 해야하는데 정신 나가니 그냥 vpn 연결해서 본인 pc에 다운로드 받고 filezilla로 옮기면 됩니다. 그게 마음 편해요. 아니면 지도교수님 찾아가서 홍콩으로 통하는 vpn 설치 하게 해달라고 구걸하는것도 방법입니다.
물론 설치는 본인이 해야하고 따로 네트워크 공부도 해야하고 슬프겠지만 성공하면 기쁩니다.