개발
경로 문자열 검사로는 심링크를 못 막는다
2026.09.16 · 2분
옵시디언 노트를 블로그로 올리는 CLI 를 만들었다. vault 폴더를 훑어서 .md 파일을
읽고 발행이 끝나면 노트에 주소를 되쓴다.
읽고 쓰는 도구라 폴더 밖으로 나가면 안 된다. 그래서 경로 검사를 넣었다.
vault 안의 경로인가?
상위로 올라가는 표기가 없는가?
이 검사는 심링크를 하나도 못 막는다.
심링크에는 상위 경로 표기가 없다
당연한 이야기인데 놓쳤다.
vault/메모.md → /home/jun/.ssh/id_rsa
경로 문자열은 메모.md 다. 점 두 개도 없고 슬래시로 시작하지도 않는다. 문자열
검사를 전부 통과한다. vault 안에 얌전히 있는 파일로 보인다.
그런데 파일을 읽는 함수는 링크를 따라간다. 쓰는 함수도 따라간다.
문자열은 멀쩡한데 실제로 닿는 곳이 다르다. 앞서 URL 검사에서 당한 것과 같은 모양이다 — 우리가 보는 것과 실제로 해석하는 쪽이 보는 것이 다르다.
실제로 vault 바깥 파일이 고쳐졌다
가정이 아니다. 테스트해 봤더니 vault 바깥의 파일이 실제로 수정됐다. CLI 가 발행 결과를 노트에 되쓰는 단계에서 링크를 따라가 엉뚱한 파일을 덮어썼다.
realpath 로 판정한다
고친 방법은 단순하다. 경로를 실제 경로로 푼 다음 vault 안인지 본다.
실제 경로 = realpath(후보)
vault 실제 경로로 시작하는가?
여기서 중요한 건 vault 쪽도 실제 경로로 풀어야 한다는 것이다. vault 자체가 심링크를 거쳐 있으면 한쪽만 풀었을 때 비교가 안 맞는다.
그리고 읽기와 쓰기 양쪽에서 부른다. 처음엔 쓰기만 막으면 되는 줄 알았다.
읽기가 더 위험했다
쓰기는 덮어쓰는 것이니 위험해 보인다. 그런데 이 도구에서는 읽기가 더 위험했다.
훑는 규칙이 ".md 로 끝나는 파일" 이다. 그건 링크의 이름을 본다. 링크 이름이
메모.md 면 확장자 검사를 통과하고 실제 대상이 무엇이든 상관없다.
vault/메모.md → ~/.ssh/id_rsa
이 파일의 내용이 블로그 본문으로 올라간다. 개인 키가 공개 글이 된다.
쓰기는 파일 하나가 망가지는 일이고 읽기는 내용이 인터넷으로 나가는 일이다.
파일 종류를 볼 때 걸리는 함정
디렉터리를 훑을 때 항목마다 파일인지 폴더인지 본다. Node 가 주는 항목 객체에
isFile() 과 isDirectory() 가 있어서 그걸 썼다.
심링크에서는 둘 다 거짓이다. 링크를 따라가지 않기 때문이다. 링크는 링크일 뿐 파일도 폴더도 아니다.
그래서 처음 짠 코드는 심링크를 조용히 건너뛰고 있었다. 우연히 안전했던 셈이다. 그런데 나는 그걸 모르고 "읽기도 뚫린다" 고 단정해 버렸다 — 재보지 않고 말한 것이었다.
지금은 링크를 먼저 푼 다음 실제 경로로 종류를 본다. 그래야 심링크로 연결된 진짜 폴더도 따라 들어갈 수 있고 판정과 실제가 어긋나지 않는다.
막힌 경로를 로그에 찍지 않는다
하나 더. vault 밖을 가리키는 항목을 발견하면 건너뛰면서 기록을 남기는데, 어디를 가리켰는지는 찍지 않는다.
바깥을 가리켜 건너뜀: 메모.md
가리킨 경로 자체가 알려서는 안 되는 정보다. ~/.ssh/id_rsa 를 가리켰다고 로그에
남기면, 그 로그를 붙여 넣는 순간 남의 홈 디렉터리 구조가 나간다. 로그를 이슈나
채팅에 붙이는 일은 흔하다.
남는 것
두 가지가 남았다.
첫째, 경로 검사는 문자열 검사가 아니다. 파일 시스템에 물어봐야 한다. 상위 경로 표기를 막는 정규식은 필요하지만 충분하지 않다.
둘째, 재보기 전에 단정하지 말자. 나는 "읽기 쪽도 뚫린다" 고 했는데 실제로는
심링크가 조용히 걸러지고 있었다. 결론은 같았다 — 어쨌든 realpath 로 막아야 한다 —
지만, 근거가 틀렸다. 근거가 틀리면 다음에 비슷한 판단을 할 때 또 틀린다.
앞선 URL 검사 이야기와 같은 교훈이다. 검사하는 쪽과 실제로 해석하는 쪽이 다른 것을 보고 있으면, 그 차이가 곧 구멍이다.
이 글은 AI 가 조사·초안을 작성하고 사람이 검수한 뒤 발행했습니다.