首次推出firefox.

2025-12-06 12:28:28 +08:00 · 2024-11-01 14:15:00 +08:00
parent 0857c3a848
commit b0ab511aba
8 changed files with 248 additions and 0 deletions
--- a/firefox/CHANGELOG.md
+++ b/firefox/CHANGELOG.md
@@ -0,0 +1,3 @@
+### 24.10.1 （2024-11-01）
+
+- 首次推出
--- a/firefox/DOCS.md
+++ b/firefox/DOCS.md
@@ -0,0 +1,26 @@
+# Firefox
+
+## 使用方法
+
+- 只需安装、启动容器并点击“打开 Web UI”。
+
+- 您可以使用“显示在侧边栏”以便于访问。
+
+- 您在 Firefox 中所做的一切都会持久保存。
+
+- 即使您停止插件或重启 Home Assistant 主机操作系统。
+
+## 下载
+
+- 应用内/share/firefox
+- 默认的下载地址在host主机的/mnt/data/supervisor/share/firefox 中。
+
+## 上传
+
+- 如果您需要通过 Firefox 插件上传文件，您可以使用文件编辑器插件将文件上传到您的 /mnt/data/supervisor/share/firefox 文件夹。
+
+- 文件将在插件的 downloads 文件夹中可用。当您选择文件上传时，可以浏览到这个位置。
+
+## 导入书签
+
+- 您可以通过将 bookmarks.html 文件拖放到您的 /mnt/data/supervisor/share/firefox 文件夹中，并在 Firefox 中导入 bookmarks.html 文件来导入书签。
--- a/firefox/README.md
+++ b/firefox/README.md
@@ -0,0 +1,13 @@
+# 冬瓜甄选Addons: Firefox
+
+## 关于
+
+Mozilla Firefox 是由 Mozilla 基金会及其子公司 Mozilla 公司开发的免费开源网络浏览器。
+
+## 源
+
+[https://github.com/Mincka/ha-addons](https://github.com/Mincka/ha-addons)
+
+[https://github.com/jlesage/docker-firefox](https://github.com/jlesage/docker-firefox)
+
+[https://hub.docker.com/r/jlesage/firefox/tags](https://hub.docker.com/r/jlesage/firefox/tags)
--- a/firefox/config.yaml
+++ b/firefox/config.yaml
@@ -0,0 +1,76 @@
+name: "Firefox"
+version: "24.10.1"
+slug: "firefox"
+panel_icon: "mdi:firefox"
+description: "火狐浏览器的Docker容器"
+url: "https://github.com/mincka/ha-addons/tree/main/firefox"
+arch:
+  - aarch64
+  - amd64
+  - armv7
+init: false
+apparmor: false
+panel_admin: false
+map:
+  - share:rw
+ingress: true
+ingress_port: 5800
+ports:
+  5800/tcp: null
+  5900/tcp: null
+  9222/tcp: null
+environment:
+  # Required to write to /data
+  USER_ID: "0"
+  KEEP_APP_RUNNING: "1"
+# Sound support (forward audio to your host), not tested
+devices:
+  - /dev/snd
+# Map a working PulseAudio setup into the container
+audio: true
+image: r.hassbus.com/wghaos/firefox
+# To pass options as environment variables (thanks to legacy mode), they must be either "int" or "str" ("str?" will be ignored).
+legacy: true
+boot: manual
+options:
+  VNC_PASSWORD: ""
+  ENABLE_CJK_FONT: "1"
+  FF_OPEN_URL: ""
+  FF_KIOSK: "0"
+  LANG: "zh_CN.UTF-8"
+  TZ: "Asia/shanghai"
+  INSTALL_PACKAGES: ""
+  PACKAGES_MIRROR: ""
+  CONTAINER_DEBUG: "0"
+  DISPLAY_WIDTH: "1920"
+  DISPLAY_HEIGHT: "1080"
+  DARK_MODE: "0"
+  SECURE_CONNECTION: "0"
+  SECURE_CONNECTION_VNC_METHOD: "SSL"
+  SECURE_CONNECTION_CERTS_CHECK_INTERVAL: "60"
+  WEB_AUDIO: "0"
+  WEB_AUTHENTICATION: "0"
+  WEB_AUTHENTICATION_USERNAME: ""
+  WEB_AUTHENTICATION_PASSWORD: "0"
+  FF_CUSTOM_ARGS: ""
+schema:
+  VNC_PASSWORD: str
+  ENABLE_CJK_FONT: str
+  FF_OPEN_URL: str
+  FF_KIOSK: str
+  LANG: str
+  TZ: str
+  INSTALL_PACKAGES: str
+  PACKAGES_MIRROR: str
+  CONTAINER_DEBUG: str
+  DISPLAY_WIDTH: str
+  DISPLAY_HEIGHT: str
+  DARK_MODE: str
+  SECURE_CONNECTION: str
+  SECURE_CONNECTION_VNC_METHOD: str
+  SECURE_CONNECTION_CERTS_CHECK_INTERVAL: str
+  WEB_AUDIO: str
+  WEB_AUTHENTICATION: str
+  WEB_AUTHENTICATION_USERNAME: str
+  WEB_AUTHENTICATION_PASSWORD: str
+  FF_CUSTOM_ARGS: str
--- a/firefox/icon.png
+++ b/firefox/icon.png
--- a/firefox/logo.png
+++ b/firefox/logo.png
--- a/firefox/translations/en.yaml
+++ b/firefox/translations/en.yaml
@@ -0,0 +1,65 @@
+configuration:
+  VNC_PASSWORD:
+    name: VNC Password
+    description: Password needed to connect to the application's GUI. If you set a value, the only way to remove it will be to reinstall the add-on. Password is limited to 8 characters because due to a limitation of the Remote Framebuffer Protocol RFC (see section 7.2.2).
+  ENABLE_CJK_FONT:
+    name: Enable CJK font
+    description: When set to 1, open-source computer font WenQuanYi Zen Hei is installed. This font contains a large range of Chinese/Japanese/Korean characters.
+  FF_OPEN_URL:
+    name: Firefox Open URL
+    description: The URL to open when Firefox starts. If you set a value, the only way to remove it will be to reinstall the add-on.
+  FF_KIOSK:
+    name: Firefox Kiosk Mode
+    description: When set to 1, kiosk mode is enabled. This mode launches Firefox in a very restricted and limited mode best suitable for public areas or customer-facing displays.
+  LANG:
+    name: Locale
+    description: Set the locale, which defines the application's language, if supported. Format of the locale is language[_territory][.codeset], where language is an ISO 639 language code, territory is an ISO 3166 country code and codeset is a character set, like UTF-8. For example, Australian English using the UTF-8 encoding is en_AU.UTF-8.
+  TZ:
+    name: Timezone
+    description: TimeZone used by the container. Timezone can also be set by mapping /etc/localtime between the host and the container.
+  INSTALL_PACKAGES:
+    name: Install Packages
+    description: Space-separated list of packages to install during the startup of the container. List of available packages can be found at https://mirrors.alpinelinux.org. ATTENTION - Container functionality can be affected when installing a package that overrides existing container files (e.g. binaries).
+  PACKAGES_MIRROR:
+    name: Packages Mirror
+    description: Mirror of the repository to use when installing packages. List of mirrors is available at https://mirrors.alpinelinux.org.
+  CONTAINER_DEBUG:
+    name: Container Debug
+    description: When set to 1, debug logging is enabled. 
+  DISPLAY_WIDTH:
+    name: Display Width
+    description: Width (in pixels) of the application's window.
+  DISPLAY_HEIGHT:
+    name: Display Height
+    description: Height (in pixels) of the application's window.
+  DARK_MODE:
+    name: Firefox Dark Mode
+    description: When set to 1, dark mode is enabled for the application.
+  SECURE_CONNECTION:
+    name: Secure Connection
+    description: When set to 1, an encrypted connection is used to access the application's GUI (either via a web browser or VNC client). This may not be compatible with HA Ingress (even in HTTPS). Note that few VNC clients support this method. SSVNC is one of them. See the Security section of https://github.com/jlesage/docker-firefox for more details.
+  SECURE_CONNECTION_VNC_METHOD:
+    name: Secure Connection VNC Method
+    description: Method used to perform the secure VNC connection. Possible values are SSL or TLS. See the Security section of https://github.com/jlesage/docker-firefox for more details.
+  SECURE_CONNECTION_CERTS_CHECK_INTERVAL:
+    name: Secure Connection Certificate Check Interval
+    description: Interval, in seconds, at which the system verifies if web or VNC certificates have changed. When a change is detected, the affected services are automatically restarted. A value of 0 disables the check.
+  FF_CUSTOM_ARGS:
+    name: Firefox Custom Arguments
+    description: Custom argument(s) to pass when launching Firefox.
+  WEB_AUDIO:
+    name: Web Audio
+    description: When set to 1, audio support is enabled, meaning that any audio produced by the application is played through the browser. Don't forget to also enable audio in the VNC docked console. Note that audio is not supported for VNC clients, nor HA Ingress. Please tell me if you find a way to make it work through HA ingress.
+  WEB_AUTHENTICATION:
+    name: Web Authentication
+    description: When set to 1, the application' GUI is protected via a login page when accessed via a web browser. Access is allowed only when providing valid credentials. This feature requires secure connection (SECURE_CONNECTION environment variable) to be enabled. This may not be compatible with HA ingress (even in HTTPS).
+  WEB_AUTHENTICATION_USERNAME:
+    name: Web Authentication Username
+    description: Optional username to configure for the web authentication. This is a quick and easy way to configure credentials for a single user.
+  WEB_AUTHENTICATION_PASSWORD:
+    name: Web Authentication Password
+    description: Optional password to configure for the web authentication. This is a quick and easy way to configure credentials for a single user.
+network:
+  5800/tcp: Firefox via Web (Not required for Ingress)
+  5900/tcp: Firefox via VNC (Not required for Ingress)
+  9222/tcp: Firefox Remote Debugging Port (Not required for Ingress)
--- a/firefox/translations/zh-Hans.yaml
+++ b/firefox/translations/zh-Hans.yaml
@@ -0,0 +1,65 @@
+configuration:
+  VNC_PASSWORD:
+    name: VNC 密码
+    description: 连接到应用程序图形用户界面所需的密码。如果您设置了值，移除它的唯一方式将是重新安装插件。由于远程帧缓冲协议RFC的限制（参见第7.2.2节），密码限制为8个字符。
+  ENABLE_CJK_FONT:
+    name: 启用中文日韩字体
+    description: 设置为1时，将安装开源计算机字体文泉驿正黑。该字体包含大量的中文/日文/韩文字符。
+  FF_OPEN_URL:
+    name: Firefox 打开 URL
+    description: Firefox启动时打开的URL。如果您设置了值，移除它的唯一方式将是重新安装插件。
+  FF_KIOSK:
+    name: Firefox iosk模式
+    description: 设置为1时，启用iosk模式。此模式以非常受限和有限的模式启动Firefox，最适合公共区域或面向客户的展示。
+  LANG:
+    name: 地区设置
+    description: 设置地区，定义应用程序的语言（如果支持）。地区的格式是language[_territory][.codeset]，其中language是ISO 639语言代码，territory是ISO 3166国家代码，codeset是字符集，如UTF-8。例如，使用UTF-8编码的澳大利亚英语是en_AU.UTF-8。
+  TZ:
+    name: 时区
+    description: 容器使用的时区。也可以通过在主机和容器之间映射/etc/localtime来设置时区。
+  INSTALL_PACKAGES:
+    name: 安装软件包
+    description: 在容器启动期间安装的软件包列表，空格分隔。可用软件包列表可在 https://mirrors.alpinelinux.org 查看。注意 - 安装覆盖现有容器文件的软件包可能会影响容器功能（例如二进制文件）。
+  PACKAGES_MIRROR:
+    name: 软件包镜像
+    description: 安装软件包时使用的仓库镜像。镜像列表可在 https://mirrors.alpinelinux.org 查看。
+  CONTAINER_DEBUG:
+    name: 容器调试
+    description: 设置为1时，启用调试日志。
+  DISPLAY_WIDTH:
+    name: 显示宽度
+    description: 应用程序窗口的宽度（像素值）。
+  DISPLAY_HEIGHT:
+    name: 显示高度
+    description: 应用程序窗口的高度（像素值）。
+  DARK_MODE:
+    name: Firefox 暗色模式
+    description: 设置为1时，启用应用程序的暗色模式。
+  SECURE_CONNECTION:
+    name: 安全连接
+    description: 设置为1时，使用加密连接访问应用程序的GUI（通过Web浏览器或VNC客户端）。这可能与HA Ingress（即使是HTTPS）不兼容。请注意，很少有VNC客户端支持这种方法。SSVNC是其中之一。更多细节请参阅 https://github.com/jlesage/docker-firefox 的安全部分。
+  SECURE_CONNECTION_VNC_METHOD:
+    name: 安全连接VNC方法
+    description: 执行安全VNC连接的方法。可能的值是SSL或TLS。更多细节请参阅 https://github.com/jlesage/docker-firefox 的安全部分。
+  SECURE_CONNECTION_CERTS_CHECK_INTERVAL:
+    name: 安全连接证书检查间隔
+    description: 系统检查Web或VNC证书是否更改的间隔（秒）。当检测到更改时，受影响的服务将自动重启。值为0时禁用检查。
+  FF_CUSTOM_ARGS:
+    name: Firefox自定义参数
+    description: 启动Firefox时传递的自定义参数。
+  WEB_AUDIO:
+    name: Web音频
+    description: 设置为1时，启用音频支持，这意味着应用程序产生的任何音频都通过浏览器播放。不要忘记在VNC停靠的控制台中启用音频。请注意，VNC客户端和HA Ingress不支持音频。如果您找到了通过HA ingress使其工作的方法，请告诉我。
+  WEB_AUTHENTICATION:
+    name: Web认证
+    description: 设置为1时，应用程序的GUI在通过Web浏览器访问时受到登录页面的保护。只有在提供有效凭证时才允许访问。此功能需要启用安全连接（SECURE_CONNECTION环境变量）。这可能与HA ingress（即使是HTTPS）不兼容。
+  WEB_AUTHENTICATION_USERNAME:
+    name: Web认证用户名
+    description: 为Web认证配置的可选用户名。这是为单个用户配置凭证的快速简便方式。
+  WEB_AUTHENTICATION_PASSWORD:
+    name: Web认证密码
+    description: 为Web认证配置的可选密码。这是为单个用户配置凭证的快速简便方式。
+network:
+  5800/tcp: 通过Web访问Firefox（Ingress不需要）
+  5900/tcp: 通过VNC访问Firefox（Ingress不需要）
+  9222/tcp: Firefox远程调试端口（Ingress不需要）