[Python] 라즈베리파이 5 헤드리스 Playwright 자동화: 세션 유지와 중복 발행 방지
2026년 11월 20일 09시 21분 48초에 업로드 된 글입니다.작성자: kugorang728x90TL;DR (세 줄 요약)
- 모니터가 없는 라즈베리파이 5에서는 다른 컴퓨터에서 만든 로그인 쿠키를 넣고, 검증한 프로필 폴더를 이름 바꾸기로 한 번에 교체해서 로그인 세션을 지킵니다.
- 종료 코드를
0,1,2,5로 나누고 검증을 4단계로 둡니다. 버튼을 찾지 못해 실패했을 때만 자동 복구를 1회 실행합니다. - 파일 잠금(
flock)과fsync로 쓴 기록 세 가지로, 같은 글이 두 번 발행되는 일을 막습니다.
라즈베리파이 5 한 대에서 1분마다 워커를 실행해서 블로그 글을 자동으로 발행합니다. 라즈베리파이 5는 손바닥 크기의 작은 컴퓨터이고, 워커는 정해진 작업을 반복해서 실행하는 프로그램입니다. 이 기기에는 모니터도 키보드도 없습니다.
먼저 용어 세 가지를 설명합니다.
- Playwright: 코드로 웹 브라우저를 조작하는 도구입니다.
- 헤드리스: 화면에 창을 띄우지 않고 브라우저를 실행하는 방식입니다.
- 종료 코드(exit code): 프로그램이 끝나면서 운영체제에 남기는 숫자입니다. 0은 성공이고, 나머지 숫자는 실패의 종류를 뜻합니다.
이 글에서는 자동화가 실패하는 원인 세 가지, 세션을 지키는 구조, 복구와 중복 방지 설계를 순서대로 설명합니다.
주의할 점: 글을 자동으로 발행하는 프로그램은 각 서비스의 이용약관과 운영정책이 허용하는 범위에서만 써야 합니다. 서비스가 공식 API를 제공하면 브라우저 자동화 대신 공식 API를 씁니다. X는 자동화 규칙에서 공식 API가 아닌 방식의 자동화를 금지합니다. 그래서 X에 올릴 때는 공식 API를 써야 합니다.
1. 모니터 없는 라즈베리파이 5에서 웹 자동화는 왜 실패하나요?
로그인 창을 띄울 화면이 없습니다
$DISPLAY는 리눅스가 창을 그릴 화면의 주소를 적어 두는 환경 변수입니다. 모니터가 없으면 이 값이 비어 있습니다.headless=False로 브라우저를 열면 브라우저가 창을 그릴 곳을 찾지 못해서 바로 종료됩니다. 그래서 사람이 아이디와 비밀번호를 직접 입력하는 로그인 절차를 진행할 수 없습니다.시간 초과 뒤에 다시 시도하면 글이 두 번 발행됩니다
발행 버튼을 누른 뒤 제한 시간 안에 응답이 오지 않으면 프로그램은 실패로 판단합니다. 하지만 서버에는 글이 이미 저장됐을 수 있습니다. "응답을 받지 못했다"와 "발행이 안 됐다"는 서로 다른 사실입니다. 이 둘을 구분하지 않고 다시 시도하면 글이 두 번 올라갑니다.
상태 파일이 0바이트로 깨집니다
systemd는 리눅스에서 프로그램을 정해진 주기로 실행해 주는 관리 프로그램입니다. 주기가 1분이면 앞선 실행이 끝나기 전에 다음 실행이 시작될 수 있습니다. 두 프로세스가 상태 JSON 파일을 동시에 쓰거나, 쓰는 도중에 전원이 꺼지면 파일이 0바이트로 남습니다. 파일을 여는 순간 기존 내용은 지워지는데, 새 내용은 아직 디스크에 기록되지 않았기 때문입니다.2. 로그인 세션은 어떻게 옮기고 지키나요?
이 부분은
poster_common.py(47,470바이트)가 맡습니다.비밀 값은 세 가지 통로로만 받습니다
로그인은 모니터가 있는 다른 컴퓨터에서 합니다. 그 결과인 쿠키나
storage_stateJSON만 라즈베리파이로 옮깁니다. 쿠키는 로그인 상태를 기억하려고 브라우저가 저장하는 작은 데이터입니다.storage_state는 브라우저의 로그인 정보를 파일 하나로 묶은 것입니다. 입력 통로는 세 가지입니다.- 표준 입력(
stdin): 다른 프로그램의 출력을 바로 넘겨받는 통로입니다. - 숨김 입력(
getpass): 입력한 글자를 화면에 표시하지 않는 함수입니다. - 환경 변수: 프로그램을 실행할 때 함께 넘기는 값입니다.
명령줄 인자는 쓰지 않습니다. 인자는
ps명령의 출력과 셸 기록에 남기 때문입니다. 받은 쿠키 가운데 허용한 도메인에 속한 것만 남기고 나머지는 버립니다. 환경 변수는 읽은 즉시os.environ.pop으로 지웁니다. 지우지 않으면 이어서 실행되는 브라우저의 자식 프로세스가 그 값을 물려받습니다.임시 폴더에서 검증한 뒤 이름만 바꿉니다
- 쿠키를 사용 중인 프로필 폴더에 넣지 않고
.importing임시 폴더에 먼저 넣습니다. - 헤드리스 브라우저를 연속으로 2번 다시 띄웁니다. 첫 번째에는 쿠키를 디스크에 씁니다. 두 번째에는 디스크에서 읽은 쿠키만으로 로그인이 유지되는지 확인합니다. 메모리에만 있던 쿠키는 이 단계에서 걸러집니다.
- 검증을 통과하면
SingletonLock을 확인합니다.SingletonLock은 크롬이 프로필 폴더에 만드는 표시 파일입니다. 그 폴더를 쓰고 있는 프로세스의 번호(PID)가 적혀 있습니다. - 그 PID의 프로세스가 살아 있으면 교체를 중단합니다. 살아 있지 않으면 기존 폴더를
.previous로 옮기고,.importing을os.rename으로 원래 이름으로 바꿉니다.
같은 디스크 안에서 이름을 바꾸는 작업은 완전히 끝나거나 전혀 일어나지 않습니다. 이 성질을 "원자적"이라고 부릅니다. 두 번의 이름 바꾸기 사이에 전원이 꺼지면
.previous만 남습니다. 다음 실행에서 이 상태를 발견하면.previous를 원래 이름으로 되돌립니다.3. JSON 파일은 어떻게 깨지지 않게 쓰나요?
JSON 파일도 같은 원리로 씁니다. 쓰는 함수와 값은 세 가지입니다.
os.fsync: 메모리에 머물던 내용을 디스크에 실제로 기록하라고 운영체제에 요청하는 함수입니다.os.replace: 새 파일을 기존 파일의 이름으로 한 번에 바꿔 넣는 함수입니다.0o600: 파일의 소유자만 읽고 쓸 수 있다는 권한 값입니다.
아래는
poster_common.py의 핵심 흐름을 요약한 예시입니다. 실제 코드를 그대로 옮긴 것이 아닙니다.import json import os import tempfile def write_private_json(path: str, data: dict) -> None: directory = os.path.dirname(os.path.abspath(path)) fd, tmp_path = tempfile.mkstemp(dir=directory, prefix=".tmp-") try: os.fchmod(fd, 0o600) # 소유자만 읽기/쓰기 with os.fdopen(fd, "w", encoding="utf-8") as f: json.dump(data, f, ensure_ascii=False, indent=2) f.flush() os.fsync(f.fileno()) # 파일 내용을 디스크에 기록 os.replace(tmp_path, path) # 이름을 한 번에 교체 except BaseException: if os.path.exists(tmp_path): os.unlink(tmp_path) raise dir_fd = os.open(directory, os.O_RDONLY) try: os.fsync(dir_fd) # 이름 변경 기록까지 디스크에 기록 finally: os.close(dir_fd)마지막에 부모 디렉터리까지
fsync하는 이유는 파일 이름을 바꾼 기록이 디렉터리에 저장되기 때문입니다. 이 단계를 빼면 전원이 꺼진 뒤에 이름이 다시 예전 파일을 가리킬 수 있습니다. 이 함수로 쓴 파일에는 예전 내용 전체나 새 내용 전체 가운데 하나만 남습니다. 1번에서 본 0바이트 상태는 생기지 않습니다.4. 실패하면 어떻게 복구하나요?
이 부분은
agy_repair.py(32,981바이트)가 맡습니다. 워커는 게시기의 종료 코드를 읽고 다음 행동을 정합니다. 게시기는 글을 실제로 올리는 프로그램입니다.
종료 코드 뜻 다음 행동 exit 0발행 완료입니다. 끝냅니다. exit 1입력, 세션, 서버 오류입니다. 코드를 고쳐도 해결되지 않으므로 수리를 부르지 않습니다. exit 2셀렉터를 찾지 못했습니다. 셀렉터는 웹 페이지에서 버튼 같은 요소의 위치를 가리키는 주소입니다. may_have_posted=False일 때만 복구합니다.exit 5PublishUnconfirmed입니다. 발행 버튼을 누른 뒤 결과를 확인하지 못했다는 뜻입니다.글이 이미 올라갔을 수 있으므로 자동 재시도를 막습니다. 사람이 풀어 주기 전까지 다시 실행하지 않습니다. 진단 파일
last_selector_error.json은 이번 실행 이후에 갱신된 것만 인정합니다. 지난 실행의 낡은 기록으로 엉뚱한 수리를 하지 않기 위해서입니다. 이 파일에서 이메일과 쿼리는 지우고,0o600권한으로 저장합니다. JSON이 깨져 있으면 발행 여부를 알 수 없으므로exit 5로 판정합니다.수리는 LLM(글을 읽고 답을 만드는 대규모 언어 모델)에게 맡기고, 1회만 실행합니다. 프롬프트에서 수정 대상을 게시기 파일 1개로 제한합니다. 사용량 한도(쿼터) 오류가 나면 예비 모델(폴백 모델)로 1회 바꿉니다. 수정이 끝나면 4단계 검증을 통과해야 합니다. 검증에서 쓰는 도구는 두 가지입니다.
py_compile: 파이썬 파일을 실행하지 않고 문법 오류만 찾는 도구입니다.- SHA-256: 파일 내용으로 계산하는 64자리 값입니다. 내용이 한 글자만 바뀌어도 값이 달라지므로, 바뀐 파일을 정확히 찾아냅니다.
아래는
agy_repair.py의 검증 흐름을 요약한 예시입니다. 실제 코드를 그대로 옮긴 것이 아닙니다.def verify_gate(target: Path, before: dict[str, str]) -> bool: after = snapshot_sha256(REPO) changed = {p for p in after if after[p] != before.get(p)} ok = ( py_compile_ok(target) # 1) 문법 통과 and changed == {str(target)} # 2) 대상 1개만, 해시 변화 확인 and not any(p.startswith("common/") or p in PROTECTED for p in changed) # 3) 공통 모듈, 보호 파일 무변경 and git_status_paths() <= {str(target)} # 4) git status 범위 ) if not ok: shutil.copy2(f"{target}.bak", target) # 위반 시 원복 return ok- 문법 검사를 통과해야 합니다.
- 바뀐 파일이 수정 대상 1개뿐이어야 합니다.
- 공통 모듈(
common/)과 보호 파일은 바뀌지 않아야 합니다. git status에 나오는 변경 범위가 수정 대상 안에 있어야 합니다.
네 조건 가운데 하나라도 어기면
.bak백업으로 되돌립니다.5. 같은 글이 두 번 올라가는 일은 어떻게 막나요?
이 부분은
rpi5_notion_worker.py(133,759바이트)가 맡습니다. 워커는 다섯 단계로 중복 발행을 막습니다.
fcntl.flock으로 기다리지 않는 잠금을 겁니다.flock은 파일에 잠금을 걸어서 한 번에 프로그램 하나만 실행되게 하는 운영체제 기능입니다. 잠금이 이미 있으면 기다리지 않고 바로 종료합니다. 그래서 워커 두 개가 동시에 발행하지 못합니다.- 슬롯 키를
YYYYMMDD-NN형식으로 통일합니다. 슬롯은 발행할 글 하나에 붙이는 번호입니다. 표기가 달라서 같은 글이 다른 글로 인식되는 일을 막습니다. - 기록 세 가지를 차례로 확인합니다. 기기 안의 워커 기록
notion_worker_state.json, 작업 폴더의 기록published_urls.json, 원격 페이지의 완료 표시와 게시 URL입니다. - 게시기를 실행하기 전에
posting상태를fsync로 먼저 기록합니다. 전원이 꺼져도 발행을 시도했다는 기록이 디스크에 남습니다. exit 5가 나오면 슬롯을needs_manual_check상태로 격리합니다. 사람이--resolve-slot으로 풀기 전에는 다시 실행하지 않습니다.
6. 테스트 결과는 어땠나요?
항목 걸린 시간 결과 common모듈 단위 테스트(47건)428.0 ms 통과 rpi5-tistory-poster단위 테스트(43건)913.3 ms 통과 rpi5-naver-poster단위 테스트(35건)291.9 ms 통과 rpi5-x-poster게시기 단위 테스트(63건)478.1 ms 통과(모듈 4개의 핵심 단위 테스트 합계 188건) 저장소 전체 파일 40개(748,539바이트)의 SHA-256 계산 939.26 ms 완료 저장소의 Python 파일 30개 py_compile문법 검사1,035.10 ms 완료 위 결과는 네트워크와 실제 브라우저 없이 실행한 모의 단위 테스트입니다. ARM64 라즈베리파이 5 실제 기기의 Chromium 셀렉터와
systemd타이머 연동은 실제 기기에서 따로 검증해야 합니다. "코드 수정 ≠ 모의 시험 ≠ 실기기 검증 ≠ 운영 반영"입니다.자주 묻는 질문 (FAQ)
Q1. 셀렉터를 복구하는 중에 LLM이 공통 모듈이나 중복 방지 코드를 건드리면 어떻게 막나요?
두 단계로 막습니다. 먼저 프롬프트에서 수정 대상을 게시기 파일 1개로 제한합니다. 그다음 검증 단계에서 수정 전과 후의 SHA-256 값을 비교합니다.
common/공통 모듈이나 보호 파일의 값이 바뀌었으면 수정 전체를.bak백업으로 되돌립니다.Q2. 발행 버튼을 누른 직후에 네트워크가 끊기면 같은 글이 두 번 올라가지 않나요?
올라가지 않습니다. 버튼을 누른 뒤 결과를 확인하지 못하면 게시기는
exit 5로 끝납니다. 워커는 그 슬롯을needs_manual_check로 격리합니다. 사람이 실제로 글이 올라갔는지 확인하고--resolve-slot으로 풀 때까지 그 슬롯은 다시 실행하지 않습니다.Q3. 모니터가 없는 환경에서 만료된 쿠키를 다시 넣으려면 어떻게 하나요?
세션이 만료되면 게시기는
exit 1로 끝납니다. 코드 문제가 아니므로 LLM 수리를 부르지 않습니다. 화면이 있는 다른 컴퓨터에서 로그인해서 쿠키나storage_state를 내보냅니다. 그다음 라즈베리파이에서--import-cookies또는--import-state명령으로 넣습니다. 넣은 세션은.importing임시 폴더에서 2번 다시 띄우는 검증을 통과한 뒤에 기존 프로필과 한 번에 교체됩니다. 세션 파일은0o600권한으로 보호합니다.출처: 쿠고랑(kugorang)의 자동화 저장소에서 직접 잰 기록입니다(common/poster_common.py, common/agy_repair.py, rpi5_notion_worker.py).
참고 자료
- Playwright 공식 문서: Authentication (storage_state)
- Python 공식 문서: os.replace
- Python 공식 문서: fcntl (flock)
- X 고객센터: Automation rules
함께 읽으면 좋은 글: 메모리 1GB 서버에서 프로그램이 꺼지는 이유와 스왑 설정, 라즈베리파이5에 Docker Engine 설치하기
728x90728x90'시스템 & 인프라 > Linux & DevOps' 카테고리의 다른 글
[Linux/DevOps] 메모리 1GB 서버에서 프로그램이 갑자기 꺼지는 이유와 스왑 메모리 설정 방법 (0) 2026.11.12 [리눅스 한 학기 살기 #13] 12주 회고: 한 일, 오래 걸린 일, 다음에 이어서 할 일 (1) 2025.06.02 [리눅스 한 학기 살기 #12] nmap으로 포트 스캔하기: 동작 원리와 법적 주의사항 (1) 2025.06.02 [리눅스 한 학기 살기 #11] htop 사용법: top과의 차이, CPU·메모리 수치 읽기 (0) 2025.05.30 [리눅스 한 학기 살기 #10] tree 명령어로 디렉터리 구조 보기: 동작 순서와 옵션 (1) 2025.05.28 다음글이 없습니다.이전글이 없습니다.댓글