IronFox

IronFox는 Divested Computing Group의 Mull Browser를 기반으로 한 포크이며, Mozilla Firefox를 기반으로 합니다. 우리의 목표는 Mull의 유산을 이어받아 일상적인 사용을 위한 무료 오픈 소스, 개인정보 보호 및 보안 중심의 웹 브라우저를 제공하는 것입니다.

[!TIP] 버그를 발견하셨나요? 짜증나는 문제가 발생했나요? 공유하고 싶은 팁, 아이디어 또는 제안이 있나요? 모든 이슈, 버그 보고서 및 제안은 통합 이슈 트래커에 제출해 주세요!

[!IMPORTANT] ⚠️ 모든 사용자는 문서를 살펴보는 것을 적극 권장합니다. 특히 제한 사항 및 자주 묻는 질문 페이지를 확인하세요!

IronFox의 본거지는 GitLab이지만, 이 저장소는 Codeberg 및 GitHub에도 미러링되어 있습니다.

IronFox 커뮤니티에 참여하고 싶으신가요?

Matrix (권장) 및 Discord에서 여러분을 만나 뵙기를 기대합니다!

앱 설치

IronFox 설치 방법에 대한 자세한 내용과 단계별 지침은 다운로드 페이지를 참조하세요.

앱 검증

패키지 ID: org.ironfoxoss.ironfox

패키지 ID (나이틀리): org.ironfoxoss.ironfox.nightly

서명 인증서의 SHA-256 해시:

C5:E2:91:B5:A5:71:F9:C8:CD:9A:97:99:C2:C9:4E:02:EC:97:03:94:88:93:F2:CA:75:6D:67:B9:42:04:F9:04

빌드

IronFox는 프로젝트를 로컬에서 더 쉽게(그리고 더 빠르게) 빌드할 수 있게 해줍니다. 예를 들어, wasi-sdk sysroot 및 llvm-project의 사전 빌드된 버전을 로컬에서 빌드하는 대신 사용합니다. F-Droid 빌드는 여전히 해당 소스를 빌드합니다.

IronFox 빌드에는 Docker 이미지를 사용하는 것이 좋습니다.

Docker로 빌드

다음 명령으로 Docker 이미지를 가져옵니다:

docker pull registry.gitlab.com/ironfox-oss/ironfox:latest

최신 IronFox 릴리스를 빌드하는 데 사용된 이미지를 가져오려면 main 태그를 사용할 수도 있습니다. 또는 정확한 버전 이름을 사용하여 해당 버전의 이미지를 가져올 수 있습니다.

예를 들어:

docker pull registry.gitlab.com/ironfox-oss/ironfox:v135-0

그런 다음 소스 파일을 설정해야 합니다.

Docker 없이 빌드

참고: 현재 최신 버전의 Fedora, macOS, secureblue 및 Ubuntu 시스템에서의 빌드가 지원됩니다. 다른 운영 체제/환경에서는 결과가 다를 수 있습니다(YMMV).

참고: macOS 사용자는 아래 단계를 따르기 전에 Homebrew를 설치해야 합니다 (아직 설치되지 않은 경우).

먼저, 아직 설치하지 않았다면 선택한 플랫폼에 맞는 git을 설치해야 합니다:

Fedora:

sudo dnf install git

macOS:

brew install git

secureblue:

git은 secureblue에 기본적으로 이미 설치되어 있으므로 할 일이 없습니다.

Ubuntu:

sudo apt install git

git을 성공적으로 설치한 후, 가장 먼저 해야 할 일은 IronFox의 소스 저장소를 클론하는 것입니다:

(클론된 저장소의 크기를 줄이기 위해 --depth=1이 아래에 지정되어 있으며, 원하는 경우 제거할 수 있습니다)

git clone --depth=1 [email protected]:ironfox-oss/IronFox.git IronFox

이제 IronFox 소스 디렉토리의 루트로 이동하여 bootstrap 스크립트를 실행해야 합니다:

(bootstrap 스크립트는 시스템에 IronFox를 빌드하는 데 필요한 종속성을 설정하고 설치합니다)

cd IronFox
./scripts/bootstrap.sh

소스 가져오기

여전히 IronFox 소스 디렉토리의 루트에서 get_sources 스크립트를 실행하여 IronFox 빌드에 필요한 외부 소스를 다운로드해야 합니다:

참고: IronFox가 현재 사용 중인 버전과 다른 버전의 종속성에 대한 소스를 가져와야 하는 경우, get_sources 스크립트를 실행하기 전에 scripts/versions.sh를 수정해야 합니다.

네트워크 속도에 따라 시간이 걸릴 수 있습니다...

./scripts/get_sources.sh

소스 준비

이제 새로 다운로드한 소스를 prebuild 스크립트로 패치/준비해야 합니다:

소스를 가져온 후 한 번 실행해야 합니다.

./scripts/prebuild.sh

빌드

마지막으로 다음 명령으로 빌드 프로세스를 시작할 수 있습니다:

./scripts/build.sh <build-variant>

여기서 <build-variant>는 빌드할 변형을 지정하며 다음 중 하나입니다:

• arm - 32비트 ARM (armeabi-v7a)
• arm64 - 64비트 ARM (arm64-v8a)
• x86_64 - 64비트 x86
• bundle - 지원되는 모든 ABI를 포함한 Android App Bundle (AAB)

bundle 대상은 AAB 외에도 각 아키텍처 (arm, arm64, x86_64) 에 대한 APK와 모든 아키텍처를 포함하는 유니버설 APK도 생성합니다.

린팅

IronFox는 주로 셸 스크립트로 구동되며, shellcheck (정적 분석) 및 shfmt (포맷팅) 으로 검사됩니다. 이들은 CI (lint-scripts 작업) 에서 자동으로 실행되며 강제 적용됩니다 — 린트 실패 시 빌드가 시작되기 전에 파이프라인이 중지됩니다.

./scripts/get_sources.sh는 두 도구를 모두 설치하고 각 커밋 전에 스테이징된 스크립트를 린트하는 git pre-commit 훅 (via core.hooksPath) 을 활성화합니다. 이 훅은 편의 기능이며 git commit --no-verify로 우회할 수 있습니다. CI가 여전히 기준(source of truth)입니다.

shellcheck 및 shfmt의 자체 복사본을 제공하는 경우 (. /scripts/get_sources.sh에서 가져오는 대신), IRONFOX_SHELLCHECK_DIR 및 IRONFOX_SHFMT_DIR을 적절한 디렉토리로 설정한 후 다음을 실행하여 pre-commit 훅을 직접 설정할 수 있습니다:

./scripts/lint-hook.sh

린팅 검사를 수동으로 실행하려면:

./scripts/lint.sh

포맷팅을 자동 수정하려면:

git ls-files 'scripts/*.sh' | xargs shfmt -w

린터 구성은 .shellcheckrc (검사) 및 .editorconfig (포맷팅) 에 있습니다.

번역

IronFox는 Weblate를 사용하여 번역됩니다. 번역에 도움을 주려면 Weblate 프로젝트를 방문하세요.

라이선스

스크립트는 GNU Affero General Public License, 버전 3 이상에 따라 라이선스가 부여됩니다.

패치에 대한 변경 사항은 해당 패치가 추가하거나 수정하는 파일의 헤더에 따라 라이선스가 부여됩니다 (Apache 2.0 또는 MPL 2.0).

Phoenix는 해당되는 경우 GNU General Public License v3.0 이상 (GPL-3.0-or-later) 에 따라 라이선스가 부여됩니다. COPYING을 참조하세요.

a-c-liberate.patch, a-s-localize-maven.patch 및 fenix-liberate.patch는 Fennec F-Droid에서 각색되었습니다. COPYING을 참조하세요.

gecko-configure-ublock-origin.patch, gecko-devtools-bypass.patch, gecko-fix-rfphelper-import.patch, gecko-prevent-exposing-name-and-vendor-to-extensions.patch 및 gecko-rs-blocker.patch는 LibreWolf에서 각색되었습니다. LibreWolf 라이선스 및 면책 조항을 참조하세요.

fenix-disable-network-connectivity-monitoring.patch, gecko-disable-network-id.patch, gecko-prevent-fingerprinting-via-chrome-resources.patch, geckoview-ironfox-settings-support-spoof-english.patch 및 glean-noop.patch는 Tor Project에서 각색되었습니다. LICENSE를 참조하세요.

현재 기본 배경화면 세트는 Fennec F-Droid에서 가져왔으며, Unsplash 라이선스에 따라 사용할 수 있습니다.

고지 사항

Mozilla Firefox는 The Mozilla Foundation의 상표입니다.

이 제품은 공식적으로 지원되는 Mozilla 제품이 아닙니다. IronFox는 Mozilla와 어떠한 방식으로도 관련이 없습니다.

IronFox는 Mozilla의 후원이나 보증을 받지 않습니다.

IronFox는 DivestOS, Divested Computing Group 또는 Mull과 어떠한 방식으로도 관련이 없습니다.

Firefox 소스 코드는 https://github.com/mozilla-firefox/firefox에서 확인할 수 있습니다.