이 글이 맞는 독자와 전제

이미 Ubuntu나 Fedora용 글로 mixed 포트 검증, systemd 유닛, TUN 모드 개념을 익숙하게 쓰고 있다가, VPS나 사내 서버, 혹은 데스크톱을 Debian 12(bookworm)로 맞춘 경우가 많습니다. 배포판만 바뀌었을 뿐 Mihomo가 하는 일은 같지만, 운영체제 쪽에서는 apt 패키지 이름, 기본 nftables 백엔드, /etc/resolv.conf와 systemd-resolved의 관계처럼 디테일이 달라져 같은 YAML을 복사해 왔는데도 「설치는 됐는데 TUN에서만 죽는다」「프로세스는 떠 있는데 브라우저만 직통이다」처럼 시간을 잡아먹는 증상이 생깁니다.

이 문서의 목표는 세 가지입니다. 첫째, Debian 12 Clash Meta를 최소한의 apt 의존성과 진단 명령으로 재현 가능하게 두는 것. 둘째, Linux systemd 자동 시작을 유저 유닛과 시스템 유닛 관점에서 나누어, 재부팅 후에도 같은 인자로 뜨게 만드는 것. 셋째, TUN을 켠 뒤 나타나는 누락·단절을 라우팅·DNS·권한 축으로 나누어 대조하는 것입니다. Ubuntu 쪽 절차와 병행하려면 Ubuntu용 Clash Meta·systemd·TUN 가이드를 같이 열어 두면 차이가 빨리 정렬됩니다. Fedora·RHEL 계열과의 대조는 Fedora dnf·systemd·TUN 글이 보조선이 됩니다.

사전 준비: Debian 12 확인, apt, TUN 디바이스

서버 이미지는 최소 설치(minimal)인 경우가 많아 curl·dig·ss가 빠져 있을 수 있습니다. TUN을 켠 뒤 문제를 좁히려면 라우팅과 DNS를 같은 셸에서 볼 수 있어야 하므로, 아래 범주의 패키지를 미리 두는 편이 낫습니다. 명령은 조직 정책에 맞게 sudo를 붙여 실행하세요.

# Example only — adjust metapackages to your policy
sudo apt update
sudo apt install -y iproute2 dnsutils curl ca-certificates libcap2-bin procps

/dev/net/tun 존재 여부와 커널 모듈은 대부분의 공식 Debian 12 이미지에서 기본으로 갖춰져 있습니다. 커스텀 커널이나 특수 보안 프로파일을 쓴다면 ls -l /dev/net/tun으로 문자 디바이스가 보이는지, 컨테이너 내부라면 호스트가 TUN 생성을 허용하는지부터 확인합니다. Mihomo 바이너리는 배포판 패키지가 아니라 릴리스 아카이브에서 가져오는 경우가 많으므로, glibc 버전과 아키텍처(uname -m)가 릴리스 아티팩트와 맞는지 한 번 고정해 두면 이후 업그레이드 때도 혼선이 적습니다.

설치 패키지의 1차 출처는 공식 다운로드 페이지를 우선하는 것이 안전합니다. 코어 버전을 올릴 계획이면 Mihomo 업그레이드 가이드의 백업·호환 절차를 같은 작업 창에 넣어 두면 YAML 스키마 차이로 인한 재기동 루프를 줄일 수 있습니다.

디렉터리와 권한: /usr/local/bin과 상태 디렉터리

한 가지 레이아웃을 정하고 팀·개인 문서에 고정하세요. 흔한 패턴은 실행 파일을 /usr/local/bin/mihomo에 두고, 설정은 /etc/mihomo/config.yaml, 쓰기 가능한 캐시·GeoIP·룰 프로바이더는 /var/lib/mihomo로 분리하는 방식입니다. 단일 사용자 데스크톱이라면 ~/.config/mihomo 아래에 모두 두고 systemd 유저 유닛으로 띄우는 구성이 단순합니다. 어떤 경우든 구독 URL과 시크릿이 들어간 파일은 퍼미션을 600 또는 640으로 제한하고, 저장소에 예제를 올릴 때는 반드시 익명화한 스텁만 공유하세요.

Debian은 /usr/local 트리가 패키지 관리자와 분리되어 있어 바이너리를 수동 배치하기에 비교적 명확합니다. dpkg가 관리하는 경로와 섞이지 않게만 주의하면 됩니다. 포그라운드에서 한 번 실행해 로그를 직접 본 뒤 systemd에 넣는 순서를 지키면, 유닛 뒤에 숨겨진 YAML 오류를 커널 탓으로 돌리는 일이 줄어듭니다.

mixed 포트로 먼저 검증하고 TUN은 나중에

TUN 모드를 켜기 전에 tun.enable을 false로 두고 mixed-port 또는 HTTP·SOCKS 조합으로 노드·규칙 매칭이 정상인지 확인하세요. 이렇게 하면 CAP_NET_ADMIN이나 라우팅 테이블과 무관한 층에서 구독 갱신 실패, 잘못된 MATCH 폴백, DNS 모드 불일치를 먼저 제거할 수 있습니다. TUN의 개념·옵션을 정리하려면 TUN 모드 가이드를 함께 읽으면 Windows·macOS와의 차이를 빠르게 맞출 수 있습니다.

회사 HTTP 프록시 뒤에서 구독 URL이 막히면 서비스만 반복 재시작하는 패턴이 나옵니다. 같은 환경에서 curl -I로 응답 코드를 보고, 리졸버가 사내 DNS를 가리키는지 resolvectl status 또는 cat /etc/resolv.conf로 교차 검증하세요. Debian 12에서도 스텁 리스너(127.0.0.53 등)와 fake-ip 조합은 루프 증상을 만들 수 있으므로, 「OS가 이름을 해석하는 경로」와 「Mihomo가 잡으려는 경로」를 한 장짜리 다이어그램으로라도 적어 두면 이후 장애 대응이 빨라집니다.

systemd 유저 유닛으로 로그인 세션에 맞추기

개인 계정 전용이라면 ~/.config/systemd/user/mihomo.service를 만듭니다. 네트워크가 실제로 올라온 뒤 기동하려면 After=network-online.target와 Wants=network-online.target를 함께 쓰는 패턴이 무난합니다. 저장 후 systemctl --user daemon-reload, systemctl --user enable --now mihomo.service 순으로 적용합니다. 로그인 전에도 유저 서비스를 띄우려면 loginctl enable-linger가 필요할 수 있는데, 회사 장비에서는 정책과 충돌할 수 있으니 그 경우 시스템 유닛을 검토하세요.

[Unit]
Description=Clash Meta (Mihomo) user service on Debian
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=3

[Install]
WantedBy=default.target

재부팅 후에는 systemctl --user status mihomo.service와 journalctl --user -u mihomo.service -b로 같은 커맨드 라인이 재현되는지 확인합니다. 실패가 반복될 때 RestartSec을 지나치게 짧게 두면 로그가 폭주할 수 있으니 운영 값으로 조정하세요.

시스템 유닛, 전용 계정, capability

항상 켜 두는 게이트웨이나 헤드리스 서버라면 /etc/systemd/system/mihomo.service에 두고 User·Group을 전용 계정으로 고정합니다. 비루트로 TUN을 다루려면 유닛에 AmbientCapabilities=CAP_NET_ADMIN CAP_NET_BIND_SERVICE, CapabilityBoundingSet=CAP_NET_ADMIN CAP_NET_BIND_SERVICE, NoNewPrivileges=true 같은 경계를 두는 방식이 흔합니다. 조직 보안 가이드가 setcap만 허용한다면 실행 파일에 capability를 부여하고 유닛에서는 최소한만 남기는 타협도 가능합니다.

[Unit]
Description=Mihomo (Clash Meta) on Debian 12
After=network-online.target
Wants=network-online.target

[Service]
Type=simple
User=mihomo
Group=mihomo
WorkingDirectory=/var/lib/mihomo
ExecStart=/usr/local/bin/mihomo -d /var/lib/mihomo -f /etc/mihomo/config.yaml
Restart=on-failure
RestartSec=3
AmbientCapabilities=CAP_NET_BIND_SERVICE CAP_NET_ADMIN
CapabilityBoundingSet=CAP_NET_BIND_SERVICE CAP_NET_ADMIN
NoNewPrivileges=true

[Install]
WantedBy=multi-user.target

적용 순서는 sudo systemctl daemon-reload 후 sudo systemctl enable --now mihomo.service입니다. 즉시 종료되면 journalctl -u mihomo -e에서 YAML 경로, 퍼미션, 포트 충돌을 먼저 보고, TUN을 켜기 전에 mixed 경로로 되돌릴 수 있는지 확인합니다.

TUN 켜기: YAML → 재기동 → ip rule 순서

config.yaml에서 tun.enable: true를 켠 뒤 스택(system, gvisor 등)은 문서와 코어 버전에 맞게 선택합니다. 베어메탈·일반 KVM이라면 우선 system부터 시도하고, 한 번에 strict-route·DNS 하이재킹까지 모두 켜지 말고 단계를 나누세요. 재기동 후 ip link에 tun0 등 가상 인터페이스가 생겼는지, ip rule과 ip route show table all 스냅샷이 정상 시 문서에 적어 둔 것과 비슷한지 봅니다.

capability를 실행 파일에 직접 줄 환경이라면 아래와 같은 점검 패턴을 쓸 수 있습니다. 경로와 정책은 반드시 로컬 표준에 맞추세요.

# Example only — verify path and policy before running
sudo setcap cap_net_admin,cap_net_bind_service=+ep /usr/local/bin/mihomo
getcap /usr/local/bin/mihomo

증상이 「TUN만 켜면 전 구간 단절」이면 라우팅 루프나 기본 게이트웨이 충돌을 의심하고, 「일부 앱만 직통」이면 해당 앱이 고정 DNS나 QUIC를 쓰는지, 브라우저 확장이 별도 프록시를 쓰는지 나눕니다.

Debian 12에서 DNS와 resolv.conf 정렬

bookworm에서 systemd-resolved를 쓰는지, 아니면 전통적인 /etc/resolv.conf 직접 편집인지에 따라 Mihomo의 DNS 섹션과의 관계가 달라집니다. 스텁 리스너가 살아 있으면 애플리케이션이 보는 업스트림과 TUN이 가로채려는 경로가 어긋나 「연결은 되는데 이름만 이상하다」는 패턴이 나옵니다. fake-ip를 쓰는 경우에는 도메인 규칙·프로바이더 갱신 순서와의 상호작용을 로그에서 반드시 확인하세요.

실무에서는 한 가지 원칙만 고정하면 디버깅이 쉬워집니다. 「캡처된 트래픽의 DNS 최종 결정자가 Mihomo인가, OS 리졸버인가」를 문서 한 줄로 적고, 그에 맞게 프로필을 유지합니다. 사내 분할 DNS가 있다면 예외 도메인을 명시적으로 박아 두는 편이 장기적으로 안전합니다.

nftables·iptables와의 관계 메모

Debian 12 기본 흐름은 nftables 쪽에 가깝습니다. Mihomo TUN이 라우팅을 바꿀 때 로컬 방화벽 규칙이 간섭하는 경우는 드물지만, 호스팅 업체 템플릿이 공격적으로 필터를 걸어 둔 경우에는 증상이 갈립니다. 문제를 좁힐 때는 정상 시점과 장애 시점의 nft list ruleset 스냅샷을 비교해 보세요. TUN이 모든 앱을 덮지 못하는 상황에서 방화벽만 의심하기보다 DNS·프록시 UI 중복을 먼저 걷어내는 편이 시간 대비 효율이 좋은 경우가 많습니다.

증상 대조: 연결됨·누락·끊김을 어디서 볼까

아래는 포럼에서 자주 보이는 패턴을 Debian 12 관점에서 재배열한 것입니다. 절대적 진단표는 아니며, 로그와 라우팅 스냅샷으로 교차 확인해야 합니다.

  • 프로세스는 떠 있는데 브라우저만 직통: OS 프록시 설정, 확장 프로그램, 고정 DNS, TUN 미적용 앱을 의심합니다. mixed 포트로 같은 사이트를 열어 비교해 보세요.
  • TUN 켠 직후만 전체 단절: 기본 라우트·정책 라우팅 충돌, strict-route 조합, DNS 루프를 순서대로 봅니다. 한 번에 옵션을 여러 개 바꾸지 말고 되돌리기 쉬운 커밋 단위로 적용하세요.
  • 잠깐 되다가 주기적으로 끊김: 노드 품질, Keepalive, 구독 만료, 재시작 정책(Restart= 폭주)을 함께 봅니다. journalctl 타임스탬프와 코어 로그의 reconnect 메시지를 맞춥니다.
  • 설치 직후 바이너리 실행 거부: 아키텍처 불일치, 실행 비트, 불완전한 압축 해제, 보안 모듈 차단을 확인합니다. file·ldd로 빠르게 거를 수 있습니다.
  • 재부팅 후 안 뜸: enable 누락, 유저 유닛의 linger, network-online 타깃과의 의존성, 다른 서비스와의 포트 충돌을 확인합니다.
프록시·TUN 도구는 합법적인 개인정보 보호·개발·원격 업무에 쓸 수 있지만, 관할 법령·서비스 약관·고용 계약을 위반하는 우회에 사용해서는 안 됩니다. 회사 장비에서는 IT 보안 정책을 확인하세요.
오픈소스 코어의 릴리스 노트·이슈 트래커는 GitHub 등에서 확인할 수 있습니다. 다만 클라이언트 설치 패키지를 내려받는 주 경로는 공식 다운로드 페이지를 우선 참고하고, 라이선스·기여 방법은 저장소를 별도로 열람하는 편이 혼선이 적습니다.

정리

Debian 12에서 Clash Meta를 안정적으로 돌리려면 Ubuntu·Fedora 때와 같이 「바이너리·상태 디렉터리·실행 주체」를 먼저 고정하고, systemd로 재부팅 후에도 동일한 커맨드 라인이 재현되게 만든 다음, 마지막에 TUN 모드를 capability·라우팅·DNS 순으로 켜는 순서가 가장 덜 고생하는 길입니다. apt로 진단 도구를 갖추고, bookworm의 리졸버·nftables 맥락만큼은 배포판별로 메모해 두면, 나중에 팀원이 같은 스택을 복제할 때도 비용이 줄어듭니다.

규칙 설계·프로바이더 운영까지 포함한 심화 내용은 문서 허브의 관련 챕터를 함께 보시면 좋습니다. 비슷한 범주의 도구들과 비교해도 Clash 계열은 규칙 기반 분기가 성숙해 있어, 소형 Linux 게이트웨이와 데스크톱을 오가는 사용자에게 특히 잘 맞습니다.

Clash를 무료로 내려받고 Debian·Linux에 맞는 클라이언트를 선택해 보기