Troubleshooting: ${{ secrets.RCLONE_CONF }} 인코딩 오류 해결 (2025-12-26)

[creepereye1204]

---

문제 상황

1. GitHub Secret에 저장된 Rclone 설정 파일을 그대로 불러올 경우 JSON 파싱 과정에서 깨짐
2. 그 결과 CI 워크플로우 실행 시 Rclone이 정상적으로 설정을 읽지 못함

원인 분석

• Secret 값에 포함된 특수 문자(=, 줄바꿈, 공백, 따옴표 등`)가 GitHub Actions 환경 변수로 주입되는 과정에서 제대로 처리되지 않음
• 줄바꿈(\n)이나 따옴표(")가 JSON 직렬화 과정에서 깨져 정상적인 JSON 객체로 변환되지 못함
• 이로 인해 Rclone 설정 파일이 손상된 상태로 전달됨

해결 방법

1. Base64 인코딩 적용

   • 로컬에서 rclone.conf 파일을 base64로 변환
   • 변환된 문자열을 GitHub Secret에 저장

2. 워크플로우 내 디코딩 처리

   - name: Decode rclone.conf
     run: |
       echo "${{ secrets.RCLONE_CONF }}" | base64 --decode > ~/.config/rclone/rclone.conf

---