컨테이너 런타임으로 Docker 대신 Podman을 선택하는 가장 큰 이유 중 하나는 Rootless 모드를 통한 보안 격리입니다. 데몬 없이 일반 사용자 권한으로 컨테이너를 구동하면, 설령 컨테이너 내부 프로세스가 탈취되더라도 호스트 시스템의 root 권한으로 직결될 위험을 크게 낮출 수 있습니다.
다만 GitLab처럼 내부 컴포넌트가 많고 설정/데이터 볼륨 권한이 민감한 애플리케이션을 Rootless Podman으로 올릴 때는, Rootful Docker와 다른 UID/GID 매핑 구조, 1024번 미만 포트 바인딩 제약, 그리고 RHEL/Fedora 계열의 SELinux 정책을 미리 이해해야 시행착오를 줄일 수 있습니다.
이번 포스팅에서는 Rootless Podman 환경에서 GitLab을 구축하는 전 과정과 함께, 1024번 미만 포트 제한 해제, 도저히 안 될 때 setenforce로 원인을 좁히는 테스트 방법, 그리고 폐쇄망 환경에서의 한정적 완화 전략까지 실전 관점으로 정리합니다.
1. Rootless Podman 환경 체크리스트
- 사전 사양
- 메모리(RAM): 최소 4GB 이상 권장, 안정적인 운영을 위해서는 8GB 이상 권장
- 스토리지: Git 저장소 및 백업 파일 축적을 고려한 여유 공간 확보
- 도구: Rootless
podman및podman-compose(또는 Podman v4.1+ 내장podman compose) 설치 완료
- Rootless 특유의 핵심 포인트
- 1024번 미만 포트 제한: 일반 사용자(Rootless)는 기본적으로
80,443,22같은 1024번 미만 호스트 포트 직접 바인딩이 제한됩니다. 기본적으로는8080,8443,2222등 비특권 포트를 쓰거나, 호스트 커널 설정(ip_unprivileged_port_start)을 조정해 제한을 해제해야 합니다. - SubUID / SubGID 매핑: Rootless 컨테이너 안의
root(UID 0)나 서비스 계정은 호스트의 일반 사용자와/etc/subuid,/etc/subgid에 할당된 보조 UID/GID 범위로 매핑됩니다. - SELinux 컨텍스트: SELinux가
Enforcing모드인 환경에서는 호스트 볼륨 마운트 권한이나 레이블이 맞지 않아 컨테이너 기동·초기화가 꼬일 수 있습니다.
- 1024번 미만 포트 제한: 일반 사용자(Rootless)는 기본적으로
2. 1024번 미만 특권 포트 제한 해제 방법
기본적으로 리눅스 커널은 net.ipv4.ip_unprivileged_port_start 값이 1024로 설정되어 있어 일반 사용자가 1024번 미만 포트에 바인딩할 때 권한 오류가 발생합니다. 80, 443, 22번 포트(또는 80번 이상 포트)를 Rootless Podman 호스트 포트로 직접 쓰고 싶다면 호스트 관리자 권한으로 시작 포트 기준을 낮출 수 있습니다.
1) 즉시 적용 (재부팅 시 초기화)
현재 세션에 바로 반영하려면 아래 명령을 실행합니다. (예: 80번 포트까지 허용하려면 80으로 지정)
Bash
sudo sysctl -w net.ipv4.ip_unprivileged_port_start=80
(참고로 22번 포트까지 열어야 한다면 값을 22로 지정할 수 있으나, 호스트 OS의 SSH 데몬이 이미 22번 포트를 점유하고 있다면 포트 충돌이 발생하므로 호스트 SSH 포트와 겹치지 않는지 먼저 확인해야 합니다.)
2) 영구 적용 (/etc/sysctl.d/ 설정)
서버 재부팅 후에도 유지되도록 설정 파일을 만듭니다.
Bash
echo "net.ipv4.ip_unprivileged_port_start=80" | sudo tee /etc/sysctl.d/99-rootless-ports.conf sudo sysctl --system
3. 단계별 구축 가이드 (Rootless Podman)
Step 1. 영구 데이터 디렉터리 생성
일반 사용자 계정(~/gitlab) 아래에 설정, 로그, 데이터 디렉터리를 생성합니다.
Bash
mkdir -p ~/gitlab/config ~/gitlab/logs ~/gitlab/data cd ~/gitlab
Step 2. compose.yml (docker-compose.yml) 작성
Rootless Podman 환경에서 실행할 GitLab 정의 파일을 작성합니다. (이미지 태그는 gitlab/gitlab-ee:latest 또는 gitlab/gitlab-ce:latest 중 환경에 맞게 선택할 수 있습니다.)
- 옵션 A: 비특권 포트(8080 / 8443 / 2222) 사용 시 (별도 커널 수정 불필요)
YAML
services:
gitlab:
image: gitlab/gitlab-ee:latest
container_name: gitlab
restart: unless-stopped
hostname: 'gitlab.yourdomain.com'
ports:
- '8080:80' # 1024 이상 호스트 포트로 HTTP 매핑
- '8443:443' # HTTPS 직접 노출 시 사용
- '2222:22' # 호스트 SSH(22번) 충돌 방지 및 비특권 포트 매핑
environment:
GITLAB_OMNIBUS_CONFIG: |
external_url 'http://gitlab.yourdomain.com:8080'
gitlab_rails['gitlab_shell_ssh_port'] = 2222
volumes:
- './config:/etc/gitlab:Z'
- './logs:/var/log/gitlab:Z'
- './data:/var/opt/gitlab:Z'
shm_size: '256m'
- 옵션 B: 1024 포트 제한 해제 후
80:80직접 매핑 시
YAML
ports:
- '80:80' # ip_unprivileged_port_start=80 설정 후 직접 바인딩
- '8443:443'
- '2222:22'
environment:
GITLAB_OMNIBUS_CONFIG: |
external_url 'http://gitlab.yourdomain.com'
gitlab_rails['gitlab_shell_ssh_port'] = 2222
볼륨
:Z옵션 참고 SELinux가 활성화된 환경에서는 볼륨 마운트 뒤에:Z를 붙여 컨테이너가 해당 디렉터리에 접근할 수 있도록 SELinux 컨텍스트를 레이블링해 주는 것이 안전합니다.
Step 3. 컨테이너 실행 및 초기화 로그 확인
Rootless 환경에서 sudo 없이 일반 사용자로 실행합니다.
Bash
podman-compose up -d
초기 gitlab-ctl reconfigure 및 데이터베이스 초기화에는 시간이 걸리므로 아래 명령으로 로그를 확인합니다.
Bash
podman logs -f gitlab
Step 4. 초기 root 비밀번호 확인 및 초기 보안 설정
초기화가 완료되면 컨테이너 내부의 초기 비밀번호 파일을 확인합니다.
Bash
podman exec -it gitlab grep 'Password:' /etc/gitlab/initial_root_password
로그인 후에는 다음 작업을 우선 진행합니다.
root계정 비밀번호 즉시 변경- 외부 접속이 가능한 환경이라면 Admin Area → Settings → General → Sign-up restrictions에서 불필요한 회원가입 허용 옵션 비활성화
4. setenforce 테스트 및 폐쇄망 한정 해제 전략
Rootless Podman으로 GitLab을 올리다 보면 볼륨 권한, 네임스페이스 매핑, SELinux 정책 등이 얽혀 원인이 불분명한 오류가 발생할 때가 있습니다. 이럴 때는 “원인 격리 테스트”와 “망 환경에 따른 한정적 완화”를 구분해 접근해야 합니다.
4.1 setenforce로 원인 좁히기 (진단 목적)
SELinux가 Enforcing 상태일 때 권한/접근 차단이 의심된다면, 임시로 Permissive 모드로 전환해 SELinux 때문에 막힌 것인지, 아니면 다른 설정/권한 문제인지부터 판별해 볼 수 있습니다.
Bash
# 현재 SELinux 상태 확인 (Enforcing / Permissive / Disabled) getenforce # 테스트용으로 일시적 Permissive 전환 (재부팅 시 원래대로 복구) sudo setenforce 0
setenforce 0직후 정상 동작한다면: 문제의 핵심 원인이 SELinux 정책/레이블에 있다는 뜻입니다. 무작정 꺼둔 채 방치하기보다 볼륨:Z옵션, 디렉터리 컨텍스트, 감사 로그(ausearch//var/log/audit/audit.log)를 확인해 정석대로 보완하는 것이 좋습니다.setenforce 0후에도 동일하게 실패한다면: SELinux가 아니라subuid/subgid매핑, 포트 충돌, 메모리 부족,external_url오타 등 다른 요인이 원인입니다.- 테스트 종료 후 원복: 진단이 끝났다면 다시
Enforcing모드로 되돌려 확인합니다.
Bash
sudo setenforce 1
4.2 폐쇄망 환경에서의 한정적 제한 해제
외부 인터넷과 격리된 폐쇄망(사내망/에어갭 환경)에서는 외부 공격 노출면이 상대적으로 제한되므로, 운영 편의나 특정 레거시/내부 연동 요구사항에 따라 제한된 범위 내에서만 설정을 완화하는 선택지를 검토할 수 있습니다.
- 포트 제한(
ip_unprivileged_port_start) 한정 해제: 폐쇄망 내부에서 지정된 서비스 포트 대역만 쓰도록 시작 포트를 낮추거나, 반대로 내부 방화벽/접근 통제 정책이 명확한 구간에서만 한정적으로 적용합니다. - SELinux 정책 조정: 폐쇄망이라 하더라도 시스템 무결성과 내부 lateral movement 방지를 위해
Disabled로 영구 비활성화하기보다는, 필요한 디렉터리/포트 범위만 허용하거나Permissive전환 후 원인을 바로잡는 편이 안전합니다. - 참고(망간 방화벽·폐쇄망 운영 원칙): 폐쇄망이나 망분리 구간에서 외부/타 망과 연계해야 한다면 무분별한 전체 개방(
Any-Any) 대신 필요한 출발지·목적지·포트만 한정적으로 허용하고, 점검·작업 종료 후 불필요한 임시 규칙은 즉시 회수하는 원칙을 지키는 것이 안전합니다.
5. Rootless Podman 실전 트러블슈팅 및 운영 팁
1. 볼륨 권한(Permission Denied) 또는 subuid 관련 오류
- Rootless 모드에서 볼륨 마운트 시 권한 문제가 발생한다면 먼저 현재 사용자의
/etc/subuid및/etc/subgid할당 여부를 확인하고, 필요 시podman unshare명령으로 네임스페이스 내부 관점의 파일 소유권/권한을 점검해 볼 수 있습니다. - 호스트에서 임의로
chown을 잘못 건드려 매핑이 꼬였을 때는podman unshare컨텍스트 안에서 디렉터리 권한을 정리하는 것이 안전합니다.
2. 80 / 443 / 22 직접 바인딩 시 실패하는 경우
ip_unprivileged_port_start를 낮추지 않은 상태에서 Rootless 사용자 권한으로80:80등을 열려 하면 권한 오류가 발생합니다.- 2번 절의
sysctl설정으로 시작 포트를 낮추거나, 비특권 포트(8080:80,2222:22)로 매핑한 뒤GITLAB_OMNIBUS_CONFIG의external_url및gitlab_rails['gitlab_shell_ssh_port']값을 실제 접속 경로와 일치시키세요.
3. 백업 및 단계적 업그레이드
./config/gitlab-secrets.json,./config/gitlab.rb,./data/backups/는 반드시 별도 위치에 주기적으로 백업해야 합니다.- 컨테이너 이미지를 업그레이드할 때는 백업 후 GitLab 공식 업그레이드 경로를 따라 단계적으로 버전을 올리는 것이 안전합니다.
4. 로그아웃 후에도 백그라운드 유지하기 (Lingering)
SSH 세션 종료 후에도 사용자 서비스/컨테이너가 안정적으로 유지되도록 시스템에서 사용자 lingering이 활성화되어 있는지 확인해 두면 운영 편의성이 높아집니다.
Bash
loginctl enable-linger $USER
6. 마치며
Rootless Podman으로 GitLab을 구성하면 데몬 없는 사용자 단위 격리라는 보안 이점을 챙기면서도, Docker Compose와 거의 동일한 선언형 파일(compose.yml)로 깔끔하게 운영할 수 있습니다. 1024 포트 제한 해제 여부, setenforce를 통한 원인 격리 테스트, 그리고 폐쇄망 환경에 맞춘 한정적 완화 기준만 잘 잡아두면 이후 저장소 운영과 CI/CD 확장도 훨씬 수월해집니다.

답글 남기기