윈도우에서 만든 파일 하나가 DB 비밀번호를 어긋나게 만든 일: 보이지 않는 \r 찾기
작업은 윈도우 PC에서 하고, 서비스는 그 PC 위의 리눅스 가상머신에서 돌립니다. 설정 파일을 윈도우에서 만들어 서버로 복사하는 일이 잦은데, 이 조합에서 같은 종류의 버그를 두 번 만났습니다. 전부 원인은 눈에 보이지 않는 문자 하나, \r이었습니다.
배경: 줄바꿈이 두 종류다
윈도우는 줄 끝을 \r\n(CRLF) 두 글자로 표시하고, 리눅스는 \n(LF) 한 글자로 표시합니다. 윈도우에서 만든 파일을 리눅스로 옮기면 각 줄 끝에 \r이 하나씩 남습니다. 에디터에서는 보이지 않습니다. 문제는 이걸 처리하는 방식이 프로그램마다 다르다는 점입니다.
사건 1: MariaDB와 WordPress가 서로 다른 비밀번호를 읽었다
docker compose로 MariaDB와 WordPress를 띄우면서, DB 비밀번호를 compose의 secrets 기능으로 파일에서 읽게 했습니다. 비밀번호를 설정 파일에 직접 적지 않는 좋은 방법입니다.
services:
mariadb:
environment:
MARIADB_PASSWORD_FILE: /run/secrets/db_password
wordpress:
environment:
WORDPRESS_DB_PASSWORD_FILE: /run/secrets/db_password
secrets:
db_password:
file: ./secrets/db_password.txt
같은 파일을 읽는데 WordPress가 DB 접속에 실패했습니다. 비밀번호가 틀렸다는 에러였습니다.
원인은 db_password.txt를 윈도우에서 만든 데 있었습니다. 파일 끝에 \r\n이 있었고, 두 컨테이너가 파일 끝 공백을 다르게 잘라냈습니다. 한쪽은 \n만 떼어서 비밀번호 끝에 \r이 붙은 채로 계정을 만들었고, 다른 쪽은 \r\n을 모두 떼어서 접속을 시도했습니다. 사람 눈에는 같은 비밀번호인데 컴퓨터에게는 한 글자가 다른 비밀번호였습니다.
확인은 이렇게 합니다.
$ cat -A secrets/db_password.txt
MyPassw0rd^M$
^M이 바로 \r입니다. $는 줄 끝을 뜻합니다.
사건 2: 텔레그램 알림이 “malformed URL”로 실패
자동매매 봇이 죽었다 다시 뜰 때 텔레그램으로 알림을 보내는 셸 스크립트를 만들었습니다. 봇 토큰은 .env에서 꺼내 썼습니다.
TOKEN=$(grep TELEGRAM_TOKEN .env | cut -d= -f2)
curl -s "https://api.telegram.org/bot${TOKEN}/sendMessage" ...
curl이 URL 형식이 잘못됐다며 실패했습니다. 이 .env도 처음에 윈도우에서 만든 파일이었습니다. 토큰 값 끝에 \r이 붙어 URL 한가운데 들어간 겁니다.
흥미로운 건 같은 .env를 읽는 파이썬 봇 본체는 아무 문제 없이 돌고 있었다는 점입니다. python-dotenv는 CRLF를 알아서 처리해줍니다. 같은 파일이 파이썬에서는 멀쩡하고 bash에서는 깨진다는 게 이 버그를 오래 숨겨둔 이유였습니다.
한 번에 정리한 표
| 읽는 쪽 | \r 처리 | 증상 |
|---|---|---|
| python-dotenv | 알아서 제거 | 정상 동작 (그래서 문제를 숨김) |
| bash grep / cut | 그대로 남김 | URL 깨짐 |
| 컨테이너 이미지의 시크릿 처리 | 이미지마다 다름 | 계정 생성 값과 접속 값 불일치 |
고친 방법과 예방책
이미 생긴 파일은 \r을 지우면 됩니다.
sed -i 's/\r$//' secrets/*.txt .env
MariaDB는 첫 실행 때 만든 계정 비밀번호를 데이터 폴더에 저장하기 때문에, 파일만 고쳐서는 이미 만들어진 계정이 바뀌지 않습니다. 새로 설치하는 중이라면 데이터 볼륨을 지우고 다시 초기화하는 게 가장 깔끔하고, 아니라면 DB 안에서 비밀번호를 직접 다시 설정해야 합니다.
예방은 이렇게 하고 있습니다.
- 서버로 보내는 설정 파일은 에디터에서 줄바꿈을 LF로 지정해서 저장합니다. VS Code라면 오른쪽 아래 상태 표시줄의 “CRLF”를 눌러 바꿀 수 있습니다.
- git을 쓴다면
.gitattributes에*.sh text eol=lf,.env text eol=lf를 넣어둡니다. - 셸 스크립트에서 파일 값을 읽을 때는 습관적으로
tr -d '\r'를 붙입니다. - 뭔가 “분명 같은데 다르다”는 느낌이 들면 제일 먼저
cat -A로 확인합니다.
덤: 권한 문제도 같이 만났다
시크릿 파일을 고치면서 보안을 챙긴다고 권한을 600으로 잠갔더니 이번엔 WordPress가 파일을 아예 못 읽었습니다. swarm 모드가 아닌 일반 docker compose의 secrets는 호스트 파일을 그대로 bind mount하기 때문에, 호스트의 파일 권한이 컨테이너 안에도 그대로 적용됩니다. 컨테이너 안의 www-data 사용자는 root 소유 600 파일을 읽을 수 없습니다. 파일은 644로 두고 대신 상위 폴더를 700으로 잠가서 해결했습니다.
둘 다 설정 파일 한 줄짜리 문제였지만, 에러 메시지는 “비밀번호가 틀렸다”, “URL이 잘못됐다”처럼 전혀 다른 곳을 가리켰습니다. 윈도우와 리눅스를 오가며 작업한다면 \r을 의심 목록 맨 위에 두시길 권합니다.