CentOS Stream 9에서 Fedora·Ubuntu 글만으로 부족한 이유
CentOS Stream 9는 Red Hat Enterprise Linux의 업스트림이면서 장기 간 보수형 워크로드를 담당하는 회사에게도 익숙한 축입니다. 패키지 관리자 역시 dnf이고 GUI가 없는 서버에 올려도 디렉터리 구조는 Fedora와 닮았지만, 릴리스 속도와 기본 패키지 곡선이 더 보수적이라는 점에서 체감 디버깅 리듬은 다릅니다. 따라서 같은 Mihomo(Clash Meta 코어 계열 표기 중 하나로 널리 쓰입니다)라도 레퍼런스 문서 위치만 바꿔 놓아도 헷갈릴 수 있어요. 이 글은 RHEL 업스트림이라는 사용자 검색 맥락을 놓치지 않고, CentOS Stream 9 Clash Meta 설치를 시작점으로 잡았습니다.
여기까지가 왜 새 튜토리얼을 따로 두는지에 대한 현장 이유였고요, 구체 과제는 간단하게 세 가지입니다. 첫째, Mihomo Linux dnf라고 검색했을 때 곧바로 패키지가 있다고 단정하면 실패 확률이 커진다는 점을 명시하면서 필요한 패키지만 골라 끼워 넣습니다. 둘째, Clash Meta systemd 자동 시작 패턴은 유저 유닛과 시스템 유닛을 나눠 설명합니다. 즉 업무 시간에만 필요한 사람과 상시 브리지처럼 써야 하는 사람의 요구 차이입니다. 셋째, Linux TUN을 처음 켤 때 발생하는 AVC·capabilities·DNS 루프를 SELinux까지 포함해 순서를 고정했습니다.
Fedora·Ubuntu에서 이미 익숙한 절차를 그대로 답습하고 싶다면 Fedora dnf 및 SELinux 강조 튜토리얼과 Ubuntu systemd 글을 교차 참고하면 병렬 비교 속도가 가장 빠릅니다. 다만 회사 레퍼런스 이미지가 Stream 9로 고정돼 있는 조직이라면 이 글 순서 자체가 온보딩 문서에 바로 들어가도 됩니다.
배포판 버전 확인과 최소 패키지
/etc/redhat-release 또는 hostnamectl로 문자열 릴리스를 한 번 확인하세요. CentOS 또는 RHEL 패밀리라도 마이너 빌드에 따라 호환 커널 모듈이 다를 수 있습니다. 무엇보다 현재 작성 시점에서는 EL9 패밀리에서 흔히 말하는 패턴이 무엇인지 페이지 상단 검색 결과가 제목 옆 숫자에 흔들리므로 명시적인 발행 연도 접미사까지 넣어두었습니다.
가장 간단하게는 아래 카테고리 정도 최소 패키지만 남겨도 이후 디버깅이 한결 수월합니다.
# Example only — site policy dictates whether sudo is acceptable
sudo dnf install -y iproute bind-utils curl ca-certificates libcap
iproute로 정책 라우팅과 테이블을 찍어볼 수 있고, bind-utils의 dig는 회사 분할 DNS를 의심할 때 필수 라인입니다. 마지막 libcap은 capability 조정 시 도구 패키지로 같이 깔려 있는 경우가 많으니 이름이 다르다면 dnf provides setcap으로 자신의 레포를 조회하면 됩니다. 인프라 규격으로 이미 패키지가 조합돼 있다면 중복 설치 명령을 생략해도 내용에는 영향 없습니다.
커널 TUN 존재와 권한 전제 확인
TUN 디바이스 특성부터 짚으려면 우선 특수 파일 존재를 확인해야 합니다. 대부분의 EL9 계열에서는 ls -l /dev/net/tun이 실패하지 않으며, 접근 결과가 허술하게 보여도 사용자 공간 프로그램이 실제 장치 노드를 통해 인터페이스를 만들 수 있는지까지 이어져야 책임 범위를 나눌 수 있습니다. 커널 패치가 과도하게 줄어든 테스트 환경이나 컨테이너 내부와 비교해야 할 때 특히 헷갈리니, 해당 커널에서 네트워크 네임스페이스 규격을 문서 한 줄이라도 받아 놓습니다.
서버 사용자라면 초기 상태에서 root로만 테스트하는 습관이 남아 있지만, 나중에는 전용 사용자로 내려올 가능성을 염두에 두고 테스트합니다. 초기 디버깅에서 root로 재현된다가 일반 사용자로 내려왔을 때 깨진다면 TUN 허용이나 systemd 유닛의 권한 맵이 즉시 문제 후보입니다. 하드닝 규격이 있는 회사에서는 이 부분부터 스크린샷이 아니라 명령행 로그로 남기는 규칙을 두기도 하고요.
디렉터리 선택: 홈 vs /etc 고정 패턴
워크스테이션에서는 ~/.config/mihomo/config.yaml과 같이 사용자 범위에 두고 WorkingDirectory=%h/.config/mihomo 패턴으로 systemd 유저 서비스를 붙일 때가 많습니다. 반대로 회사 레퍼런스에서는 /etc/mihomo/config.yaml을 소유 번호까지 고정한 뒤 mihomo 사용자를 따로 만들고 시스템 유닛으로 돌립니다.
어떤 쪽을 택했든 실행 파일 바이너리는 패키지 관리 영역 바깥에 두는 패턴(/usr/local/bin/mihomo)으로 충돌 가능성을 낮춥니다. 업스트림이 배포 관리 패키지를 제공한다면 내부 배포 채널에 맞춰 위치만 바뀝니다만, 본 글에서는 직접 배치 플로를 기본값으로 간주합니다.
바이너리 받기 체계와 업데이트 루프
CentOS 저장소 이름과 실제 패키지 가용 여부 사이 간극 때문에 실무에서는 zip 아티팩트를 검증 받아 놓은 뒤 배포하는 패턴을 자주 마주칩니다. 개인이라면 신뢰 체계를 따라야 하므로 우선적으로 공식 클라이언트 다운로드 페이지에서 허브 정책을 확인합니다. 업데이트를 자주 하는 팀이라면 체크섬과 릴리스 노트 검토를 같은 MR 템플릿에 포함시켜 놓습니다.
버전을 올려야 하는 시점에서는 Mihomo 업그레이드 가이드처럼 백업·스키마 변화까지 한 블록으로 처리하는 접근을 그대로 이식할 수 있습니다. Stream 9는 릴리스 주기 때문에 커널 ABI가 크게 깨지진 않더라도, 오래된 바이너리를 그대로 둘수록 새 TLS 스택 검증을 미룰 위험이 있으니 업데이트 주기 표를 인프라 캘린더에 두는 게 좋습니다.
SELinux AVC를 읽어야 하는 순간
기본 상태가 enforcing이라면 무작정 permissive로 내리기보다 aureport -au나 ausearch로 AVC 이벤트를 먼저 찾아보는 순서가 맞습니다. 바이너리가 새 경로(/usr/local/bin 등)라면 레이블이 기대 타입과 달라 name_connect 등이 차단되는 일이 간헐적으로 보고됩니다. 이때 광범위한 정책 완화보다 해당 모듈에 최소 패치 파일을 제공하는 접근을 보안 검토 과정과 같이 챙길 필요가 있습니다.
직접 정책 모듈을 빌드하는 것은 학습량이 많으니 회사에서는 정책 팀에게 티켓 우선 순위만 올립니다만, 개발자 개인이라면 테스트 베드를 따로 만들고 스냅샷 레이블을 문서 화두로 남길 수 있습니다. 운영자와 개발자가 동시에 존재하는 곳이라면 허용 capability 목록을 스프레드시트 형태로 정리했다가 분기 업데이트 때마다 점검하는 방식도 이득이 큽니다.
firewalld·nft 전제와 존 간섭
Stream 9는 기본적으로 firewalld가 존 규모에서 동작하면서 nftables 계열 규칙을 다룹니다. Mihomo의 allow-lan 기능을 통해 로컬망 접근 범위를 크게 바꿀 거라면 firewall-cmd --list-all-zones 출력을 초기 상태로 붙어두세요. 순수 터널 모드에서는 방화벽보다 라우팅/DNS 순서가 먼저 의심 대상이라는 대전제는 유지하면서도 존 간섭이 있는지 교차 검증합니다.
특히 서브넷 간 포워딩이나 도커 네트워크가 깔린 환경은 중첩 존 때문에 예상 밖 순서대로 패킷이 막히기도 해서 증상이 단순 느린 인터페이스로만 표현되는 경우도 있습니다.
mixed 포트로 첫 검증부터 하기
systemd에 올려버리면 로그 줄을 보기 귀찮아지므로 초기 패턴에서는 포그라운드 기동 또는 임시 셸 alias로 상태를 들여다본 뒤 유닛을 단단히 묶길 추천합니다. Clash Meta TUN이라는 검색 결과가 기대처럼 풀린다 한들, 실무 초입에서 곧바로 tun.enable: true를 두르면 구독 URL 실패 같은 네트워크 스택 무관 증상도 권한 에러처럼 느껴져 버립니다.
# Example foreground run — substitute real path flags
sudo -u youruser /usr/local/bin/mihomo -d /home/youruser/.config/mihomo
TUN 분리 상태에서 mixed-port 또는 http-port·socks-port 조합이 정상이라면 라우팅 대신 업스트림·규칙 엔진·DNS 순서부터 살립니다.
실행 체계를 순서대로 선택하기
처음이라면 순서부터 그대로 밟도록 아래 순번을 제안합니다. 숫자는 문서 진행 순서입니다.
mihomo바이너리 검증 후 권장 경로(/usr/local/bin/mihomo) 배치 및 소유권 검토config.yaml작성 시 민감 구간 암호·토큰이 외부에 노출 안 되게chmod 600패턴 채택 여부 검토- tun 미사용 상태에서 브라우저·커맨드를 혼합해 네임스페이스 점검
- 문제 재현 패턴 확인 후 systemd 유저 유닛 혹은 시스템 유닛 작성
- 재부팅 혹은
systemctl daemon-reload루틴 테스트 - capability·SELinux 상태를 교차 검토한 다음 TUN 기능만 단계 활성화
문서에서는 동일 과정을 사람이 따라가기 위해 나열했으며, 회사에서는 이미 존재하는 배포 레시피(Chef Ansible 등)로 변환해야 할 수 있습니다.
유저 systemd 유닛 예시와 linger 이슈
~/.config/systemd/user/mihomo.service를 다음과 같은 형태로 두는 예가 많습니다.
[Unit]
Description=Clash Meta (Mihomo) Stream 9 user session
After=network-online.target
Wants=network-online.target
[Service]
Type=simple
WorkingDirectory=%h/.config/mihomo
ExecStart=/usr/local/bin/mihomo -d %h/.config/mihomo
Restart=on-failure
RestartSec=5
[Install]
WantedBy=default.target
적용 과정에서는 systemctl --user daemon-reload 다음 enable --now 조합까지 한 번만 해두면 장기 디버깅에 유리합니다. 로그아웃이면 서비스가 접히니 상시 활성 상태가 필요하다면 loginctl enable-linger를 논하는데, 회사에서는 그 자체 정책과 충돌할 가능성까지 같이 챙길 필요가 있습니다.
시스템 유닛 예시 경계 및 전용 사용자
상시 간이 게이트웨이거나 서버에 가깝다면 /etc/systemd/system/mihomo.service에 두고 사용자를 명시적인 것이 좋습니다. NoNewPrivileges 같은 하드닝 옵션은 상황에 따라 TUN 허브와 함께 쓰이기 어려울 때가 있습니다. 따라서 테스트 환경에서만 제한 두고 라인업을 줄이거나, CapabilityBoundingSet 줄을 줄이거나 등을 통해 보안 책임을 나눈 뒤에 승격 절차를 설계해야 합니다.
게이트웨이 패턴이라면 NetworkManager 또는 nmcli 상태와 간섭 검토도 함께 넣히는 장면이 존재하니 회사에서는 네트워크 책임자와 교차 디버깅이 필요하기도 해요.
Linux TUN을 capability와 함께 첫 개통
Mihomo 류는 권장 방식 안내에 따라 대개 cap_net_admin을 허브로 사용합니다만, 실제 허브 범위는 조직별 가이드를 따르세요. 테스트 중 예시 패턴 하나를 보여두면 검증 과정 속도 올립니다:
# Verify path/policy before granting capabilities
sudo setcap cap_net_admin,cap_net_bind_service=+ep /usr/local/bin/mihomo
getcap /usr/local/bin/mihomo
설정에서는 tun.enable을 켠 뒤 스택 종류 선택을 문서 순서 없이 줄줄히 다 켠다면 디버깅을 스스로 꼬입니다. 한 번 하나씩 켭니다.
DNS·systemd-resolved와 fake-ip 루프
Stream 9에서도 stub resolver 경로 때문에 fake-ip 선택과 충돌하는 양상이 나옵니다. resolvectl query와 dig @127.0.0.53 등을 통해 중간 결과를 교차해야 정확한 추적 가능성이 높습니다. 업무용 내부 도메인이 있다면 split DNS 패턴까지 YAML에 명시해야 나중 사람이 헷갈리지 않아요.
세부 패턴 참고 자료만 필요하다면 TUN 글로벌 모드 분석 글을 교차 검토해서 OS별 차별만 정리해서 붙입니다.
FAQ: 검색 패턴 묶음
아래 블록은 실제 검색 키워드와 구조적으로 닮았습니다만, FAQPage 마크업을 동시에 활용하게 하려 의도했습니다.
Mihomo dnf 패키지만으로 끝낼 수 있는가?
회사 패키지가 없다면 zip 경로 또는 내부 rpm 경로까지 같이 포함하는 문구를 붙입니다. 패키지만으로 끝낼 수 있는지 확인하려면 dnf search mihomo 결과를 레포 카탈로그와 비교해야 합니다.
systemctl에 올린 뒤 로그 줄이 줄어 신경이 줄어든다면?
그 상태에서도 종종 -d 경로 차이 때문에 조용히 꺼져버리는 패턴 있으므로 우선 journalctl --user -fu mihomo.service로 실시간 로그부터 확인하고 이후 데몬 레벨을 줄이는 순서가 안전합니다.
SELinux 때문에 mixed는 되지만 TUN만 실패하면?
capability 줄과 SELinux 정책을 동시에 의심하며 순서별로 테스트합니다.
점검 큐 순서와 스냅샷 규습
증상 순서별로 줄을 놓았을 때 디버깅 비용 최소 순서 예시는 다음처럼 둘 수 있습니다. 첫째, 재부팅 후 활성 상태 점검. 둘째, 미리 모아 놓은 journalctl --user/-u 로그 줄. 셋째, TUN 상태에서의 ip route 스냅샷 차이 여부입니다. 여기부터 DNS 루프와 SELinux를 동시 검토해야 하며, 순서 역전 시 원인 줄이 교차되어 또 한 번 순환합니다.
정상 시점과 비교해야 할 스크립트는 작은 형태든 상관없으며, 결과를 회사 게시판 같은 내부 문서 형태보다 레포 형태 템플릿으로 버전 관리하는 편을 선호하면 나중 교육 속도까지 같이 올라갑니다. 하드워어 베더들은 커널 업데이트만으로도 패킷이 조금이라도 패턴 차이 나는 순간이라 정기 교육 회고 때도 스냅샷 줄을 업데이트합니다.
장애 순환이 줄어든 팀이라면 간단 명령으로 모아 보는 패턴도 공유해야 하니, 회사에서는 이미 Ansible facts 수집 루프가 돌려지는 사례를 보기도 합니다. 이럴 때 결과를 회사 채팅 채널에 붙이기보단 암호화된 채널로 제한해야 하고 로그 줄에 토큰 노출이 없는지도 같이 교차해야 합니다.
정리와 도입 순서 회고
지금까지 CentOS Stream 9에서 필요한 순서별 체계를 순번으로 제시했고, 핵심은 dnf로 준비·mixed에서 검증·systemd 재현·TUN 권한이라는 순서 고정이라는 결론에 다시 수렴합니다. 문서 줄 수가 길더라도 기업 템플릿에서 그대로 잘린다면 이 스니펫 순서 하나면 충분하다는 회고가 나중에 따라옵니다.
기업 레퍼런스에서는 때때로 GUI 중심의 상용 VPN·프록시 제품부터 제시했지만 규칙 세분화나 트래픽 로그 교차 검증이 빠져 있어 분기 디버깅에는 부족한 경우가 많습니다. 반면 구식 「전역 터널 하나로 끝」 패턴은 경로 하나에 모든 패킷을 몰아넣다 회사 방화벽·아웃바운드 정책과 충돌하기 쉽습니다.
Clash Meta(Mihomo) 계열은 규칙 기반 디버깅과 프로파일 관리 패턴 성숙도가 높습니다. 패킷 흐름을 나누고 싶을 때 데몬 상태에서도 커널 패턴 디버깅 수단을 줄곧 제공해 주기 때문에 업무 디버깅과 개인 테스트 사이 디버깅 공간 줄을 동시 관리해야 하는 Linux 서버에서는 특히 활용 빈도가 많습니다.
클라이언트 수급처를 페이지 한 곳에서 정리해야 한다면 현재 업무 디버깅 중이라도 잠깐이라도 시간을 들여 파일 허브로 모아 놓습니다. 패키지마다 패턴이 다른 만큼 OS별 줄을 줄이려면 허브를 기준 라인 두는 편을 추천할 수 있습니다.