원래 커뮤니티 튜토리얼에서는 CasaOS에서 Docker로 Firefox를 실행하고 웹 인터페이스를 통해 브라우저에 접속하는 간단한 방법을 보여 줍니다. 이 방법은 jlesage/firefox 이미지를 사용하고, 웹 인터페이스를 포트 5800에 매핑하며, 컨테이너의 /config 디렉터리에 Firefox 데이터를 영구적으로 저장합니다.
이 원문 게시물은 2024년 12월에 작성된 CasaOS 튜토리얼이며, ZimaOS에서의 테스트가 아닙니다. 다만 핵심 Docker 매개변수가 현재 jlesage/firefox 공식 문서와 여전히 일치한다는 점은 유용합니다.
컨테이너의 세 가지 핵심 설정
커뮤니티 가이드에서는 다음 세 가지 주요 항목을 사용했습니다.
jlesage/firefox, 호스트 및 컨테이너 포트 5800, 그리고 /config에 매핑된 호스트 볼륨을 사용했습니다.- Docker 이미지:
jlesage/firefox; - 웹 인터페이스 컨테이너 포트:
5800; - 컨테이너 내부의 영구 구성 디렉터리:
/config.
현재 공식 프로젝트에서도 동일한 기본 방식을 안내합니다. 호스트 디렉터리를 /config에 매핑하고 포트 5800을 통해 브라우저 UI를 제공합니다.
/config가 중요한 이유
/config 볼륨에는 Firefox 애플리케이션 구성, 상태, 로그 및 기타 영구 데이터가 저장됩니다. 동일한 호스트 디렉터리를 계속 /config에 매핑한 상태에서 컨테이너를 다시 생성하면, 공식 프로젝트에 따르면 애플리케이션이 저장된 상태로 재개될 수 있습니다.
CasaOS의 저장소 구성과 백업 계획에 적합한 호스트 경로를 선택하세요. 원문 작성자는 /DATA/AppData/firefox와 같은 경로를 언급했지만, 정확한 호스트 경로는 모든 환경에 동일하지 않습니다.
포트 5800을 통해 브라우저에 접속하기
기본 브리지 네트워크 예시에서는 웹 인터페이스가 TCP 포트 5800으로 노출됩니다. 컨테이너가 시작되면 공식 프로젝트에서는 해당 포트의 호스트 IP를 통해 Firefox에 접속하도록 안내합니다.
호스트에서 포트 5800을 이미 사용 중이라면, 이미지 문서에 맞춰 컨테이너 측 애플리케이션 포트는 유지하면서 호스트 측 포트를 다른 포트로 매핑하세요.
권한 모드가 필수라는 근거는 확인되지 않음
커뮤니티 작성자는 “혹시 몰라서” 권한을 활성화했습니다. 그러나 이는 권한 모드가 필수라는 것을 입증한 것과는 다릅니다.
브라우저 컨테이너에 필요한 범위를 넘어서는 호스트 권한을 부여하지 마세요. 공식 이미지의 요구 사항부터 적용하고, 문서화된 기능에 필요한 경우에만 추가 권한을 부여하세요.
원문에서는 메모리 제한을 1GB로 설정함
작성자는 메모리 제한을 1024MB로 설정하고 가벼운 사용에는 충분하다고 설명했습니다. 이는 한 사용자의 할당량일 뿐, 모든 환경에 적용되는 최소 요구 사항은 아닙니다. 브라우저 메모리 사용량은 탭 수, 웹사이트, 미디어 재생, 확장 프로그램 및 세션 길이에 따라 크게 달라집니다.
동일한 이미지를 ZimaOS에서 실행할 수 있나요?
원문 게시물은 ZimaOS에서 테스트하지 않았으므로 ZimaOS 호환성의 증거로 제시해서는 안 됩니다. 다만 ZimaOS는 사용자 지정 Docker 애플리케이션을 지원하므로, 테스트를 원한다면 동일한 공식 컨테이너 매개변수를 ZimaOS Docker Compose 가져오기에 맞게 조정할 수 있습니다.
최신 ZimaOS 사용자 지정 앱 동작은 최신 ZimaOS 사용자 지정 앱 워크플로를 참고하세요.
Firefox Docker FAQ
커뮤니티 튜토리얼에서는 어떤 Docker 이미지를 사용했나요?
jlesage/firefox입니다.
Firefox 웹 인터페이스는 어떤 포트를 사용하나요?
커뮤니티 튜토리얼과 현재 공식 문서 모두 웹 인터페이스에 TCP 포트 5800을 사용합니다.
영구적인 Firefox 데이터는 어떤 컨테이너 경로에 저장되나요?
/config입니다. 컨테이너가 다시 생성된 후에도 브라우저 상태를 유지하려면 이 경로를 영구 호스트 디렉터리에 매핑하세요.
권한 모드가 필요한가요?
원문 작성자는 예방 차원에서 권한 모드를 활성화했지만, 해당 스레드에서는 필수 설정이라는 근거가 제시되지 않았습니다. 실제 배포에 필요한 최소 권한만 사용하세요.
