Ubuntu 및 Debian에서 계층별로 프록시 설정하기
ProxyV4 엔지니어링 팀 작성 · Updated:
Linux에는 통합 프록시 스위치가 없기 때문에 Ubuntu 프록시 설정은 사실상 네 가지 개별 설정으로 나뉩니다. 셸은 환경 변수를 읽고, APT는 전용 설정 디렉터리를 읽으며, systemd 서비스는 유닛 드롭인을 읽고, GNOME 데스크톱은 gsettings를 사용합니다. 사용하는 계층만 설정하면 되며, 아래 코드 스니펫은 사용자 이름과 비밀번호 인증을 사용하는 ProxyV4 HTTP(S) 프록시를 기준으로 작성되었습니다.
export http_proxy=http://user:pass@ip:port https_proxy=http://user:pass@ip:port- IP 1개US$1.85
- 3개 이상 IPUS$1.70
- 10개 이상 IPUS$1.60
- 25개 이상 IPUS$1.50
- 50개 이상 IPUS$1.40
- 100개 이상 IPUS$1.30
- 200개 이상 IPUS$1.20
- 500개 이상 IPUS$1.10
사용자 이름과 비밀번호를 사용하는 APT 프록시 설정
apt가 인증 프록시를 사용하도록 하려면 프록시 URL 내에 사용자 이름과 비밀번호를 포함하여 /etc/apt/apt.conf.d/80proxy 파일을 생성하세요. APT는 sudo 사용 여부와 관계없이 실행될 때마다 이 파일을 읽으며 셸 변수는 무시합니다:
sudo tee /etc/apt/apt.conf.d/80proxy > /dev/null << 'EOF'
Acquire::http::Proxy "http://USER:PASS@IP:PORT/";
Acquire::https::Proxy "http://USER:PASS@IP:PORT/";
EOF
sudo chmod 600 /etc/apt/apt.conf.d/80proxy
# APT가 사용할 설정을 확인한 후 테스트
apt-config dump | grep -i proxy
sudo apt update각 줄은 반드시 세미콜론으로 끝나야 하며, @, : 또는 # 문자가 포함된 비밀번호는 퍼센트 인코딩해야 합니다(@는 %40이 됨). 이후 apt update가 407 Proxy Authentication Required 오류로 중단된다면 파일에 적힌 로그인 정보가 잘못된 것입니다. 자세한 내용은 407 페이지를 참고하세요.
SOCKS5 프록시를 통한 APT 사용
최신 APT 버전(Ubuntu 18.04 이상)은 동일한 키에서 SOCKS5 URL도 지원합니다(예: Acquire::http::Proxy "socks5h://USER:PASS@IP:PORT";). 주문 시 SOCKS5 또는 듀얼 모드여야 하며 베트남 IP(HTTP 전용)는 제외됩니다. 사용 중인 APT 버전에서 해당 스킴을 지원하지 않으면 위의 HTTP 방식을 사용하세요.
단일 명령어에만 프록시 적용
설정 파일을 수정하지 않고 테스트하려면 명령줄에서 직접 옵션을 전달하세요: sudo apt -o Acquire::http::Proxy="http://USER:PASS@IP:PORT/" update. 아무것도 저장되지 않습니다.
프로그램별 프록시 설정 파일
Linux에서 "프록시가 무시된다"는 문의의 대부분은 올바른 값을 잘못된 위치에 설정했기 때문에 발생합니다. 두 가지 규칙만 알면 대부분 설명됩니다. 기본적으로 sudo는 사용자의 환경 변수를 초기화하며, systemd 서비스는 ~/.bashrc를 절대 읽지 않습니다.
| 계층 | 설정 위치 | 적용 대상 | 유지 기간 |
|---|---|---|---|
| 로그인 셸 | ~/.bashrc 또는 /etc/profile.d/proxy.sh | curl, wget, python, git, node | 새 로그인 셸마다 |
| PAM 세션 | /etc/environment | 모든 사용자 세션 | 재부팅 후에도 유지 |
| APT | /etc/apt/apt.conf.d/80proxy | apt update, apt install | 영구 적용(APT 한정) |
| systemd 유닛 | /etc/systemd/system/<svc>.service.d/proxy.conf | Docker 데몬, 자체 서비스 | daemon-reload 및 재시작 후 |
curl, wget 및 스크립트를 위한 셸 변수
변수는 소문자와 대문자 모두 정의하세요. curl과 wget은 http_proxy를 확인하지만 다른 런타임은 HTTP_PROXY만 확인합니다. no_proxy 목록을 설정하면 루프백 및 사설 IP 대역이 프록시를 거치지 않습니다.
# /etc/profile.d/proxy.sh - 셸 및 CLI 도구
sudo tee /etc/profile.d/proxy.sh > /dev/null << 'EOF'
export http_proxy="http://USER:PASS@IP:PORT"
export https_proxy="http://USER:PASS@IP:PORT"
export HTTP_PROXY="http://USER:PASS@IP:PORT"
export HTTPS_PROXY="http://USER:PASS@IP:PORT"
export no_proxy="localhost,127.0.0.1,::1,10.0.0.0/8,172.16.0.0/12,192.168.0.0/16"
export NO_PROXY="$no_proxy"
EOF
source /etc/profile.d/proxy.sh여기서도 비밀번호에 특수문자가 있다면 퍼센트 인코딩하세요. APT는 위에 설명된 대로 자체 설정 파일을 사용합니다.
systemd에서 관리하는 서비스
systemd가 시작한 데몬은 해당 유닛에 선언된 변수만 인식합니다. 드롭인 파일에 변수를 추가하고 다시 로드한 후 서비스를 재시작하세요. Docker 가이드에서 Docker 데몬과 컨테이너에 대해 자세히 다룹니다.
# /etc/systemd/system/<svc>.service.d/proxy.conf
[Service]
Environment="HTTP_PROXY=http://USER:PASS@IP:PORT"
Environment="HTTPS_PROXY=http://USER:PASS@IP:PORT"
Environment="NO_PROXY=localhost,127.0.0.1"
sudo systemctl daemon-reload
sudo systemctl restart <svc>sudo, 공유 서버 및 데스크톱 환경
- sudo: 내보낸 환경 변수를 유지하려면
sudo -E curl ...을 실행하거나,sudo visudo를 통해Defaults env_keep += "http_proxy https_proxy HTTP_PROXY HTTPS_PROXY no_proxy NO_PROXY"를 추가하여 영구적으로 적용하세요. - 다중 사용자 환경의 인증 정보: 이 파일들에는 프록시 비밀번호가 평문으로 저장됩니다.
sudo chmod 600 /etc/apt/apt.conf.d/80proxy와 같이 권한을 제한하세요. - GNOME 데스크톱: 설정 → 네트워크 → 네트워크 프록시 → 수동, 또는
gsettings set org.gnome.system.proxy mode 'manual'실행 후org.gnome.system.proxy.http아래의 호스트 및 포트 키를 설정하세요.
테스트 및 문제 해결
프로필을 적용한 후 curl -s https://api.ipify.org를 실행하면 서버 자체 주소 대신 프록시 IP가 출력되어야 합니다. 국가 및 소유자에 대한 전체 정보를 보려면 해당 IP를 IP 조회에 입력하세요. 셸 전체에 프록시를 적용하지 않으려는 경우 curl 및 Python requests 가이드에서 명령어별 대안을 확인할 수 있습니다.
단계별 안내
- 1
APT 전용 프록시 파일 생성
sudo apt update는 셸 변수를 무시하므로 Acquire::http::Proxy 및 Acquire::https::Proxy를 포함하여 /etc/apt/apt.conf.d/80proxy를 생성한 뒤 apt-config dump로 확인하세요.
- 2
/etc/profile.d/proxy.sh 작성
모든 CLI 도구에서 인식할 수 있도록 http_proxy, https_proxy, no_proxy는 소문자로, HTTP_PROXY, HTTPS_PROXY, NO_PROXY는 대문자로 내보냅니다.
- 3
필요한 경우 systemd 드롭인 추가
프록시를 사용해야 하는 각 데몬에 대해 Environment 행이 포함된 proxy.conf 드롭인을 생성한 다음, daemon-reload를 실행하고 데몬을 재시작합니다.
- 4
출구 IP 확인
source /etc/profile.d/proxy.sh를 실행한 후curl -s https://api.ipify.org를 실행합니다. 출력 결과가 프록시 IP여야 합니다.
자주 묻는 질문
http_proxy와 HTTP_PROXY를 둘 다 설정해야 하나요?
네. curl 및 wget과 같은 일부 도구는 소문자 이름을 확인하고, 다른 도구는 대문자 이름만 확인합니다. 둘 다 설정하면 예기치 않은 동작 불일치를 방지할 수 있습니다.
sudo apt update가 프록시를 사용하지 않는 이유는 무엇인가요?
sudo는 -E 옵션을 전달하지 않으면 환경 변수를 초기화합니다. /etc/apt/apt.conf.d/에 설정 파일을 두면 이에 상관없이 APT가 프록시를 사용하게 됩니다.
Ubuntu 데스크톱 GUI에서 프록시를 어떻게 설정하나요?
설정 → 네트워크 → 네트워크 프록시를 열고 수동을 선택하거나, org.gnome.system.proxy 하위에서 gsettings로 설정할 수 있습니다.
Linux 서버에서 고정 프록시가 유용한가요?
네, 원격 API나 제휴사에서 내 IP를 허용 목록에 등록할 때 유용합니다. 전용 IPv4는 갱신하는 동안 동일한 주소를 유지하므로 허용 목록 등록 상태가 유효하게 유지됩니다.
출처
서버 및 스크립트를 위한 고정 IP 프록시
사용자 이름 및 비밀번호 인증이 포함된 HTTP(S), 전용 IPv4 기반의 무제한 대역폭, 갱신할 때마다 동일하게 유지되는 주소를 제공합니다.
요금 비교하기