Messages

为了方便社区用户在线安装和管理第三方插件，我搭建了 Opnwall Community Repository，用于提供一些常用工具和网络应用，并支持通过 OPNsense 插件管理器进行安装和更新。

目前仓库包含以下插件：

• os-ddclient-opnwall —— 增强版 DDClient 替代方案，支持阿里云、腾讯云及 IPv6 接口
• os-ddns-go —— DDNS-Go 动态 DNS 集成
• os-lang —— 中文汉化工具
• os-lucky —— Lucky 网络工具箱集成
• os-mihomo —— Mihomo 代理集成
• os-pftop —— pfTop 诊断页面
• os-sing-box —— sing-box 代理集成
• os-staticarp —— ARP 静态绑定工具
• os-speedtest —— Speedtest 互联网测速工具
• os-ttyd —— ttyd Web 终端集成
• os-unboundcustom —— Unbound DNS 自定义选项

仓库将持续维护，并根据社区需求不断增加新的插件。

欢迎大家体验、反馈问题或提出建议，也欢迎参与项目贡献。

仓库地址：

https://opnwall.github.io/OPNsense-repo/

Updated to support OPNsense 26.7，please visit https://opnwall.github.io/OPNsense-repo/

[Supported platforms]

Hello everyone,
I would like to introduce the Opnwall OPNsense Community Repository, an independent community repository providing additional plugins and utilities for OPNsense.

Repository:
https://github.com/Opnwall/OPNsense-repo

Package repository:
https://opnwall.github.io/OPNsense-repo/

Supported platforms

• OPNsense 26.x
• FreeBSD 14 / FreeBSD 15
• amd64 architecture

The correct package repository is selected automatically using ${ABI}.

Installation
Log in to the OPNsense shell as root and run:

Code Select Expand

fetch -o /usr/local/etc/pkg/repos/opnwall.conf \
  https://opnwall.github.io/OPNsense-repo/opnwall.conf

pkg update -f
Then open:

Code Select Expand

System
└── Firmware
    └── Plugins
The available Opnwall packages beginning with os- should now appear in the plugin list.

Available plugins

• os-ddclient-opnwall — Extended DDClient replacement with Aliyun, Tencent Cloud and IPv6 interface support
• os-ddns-go — DDNS-Go dynamic DNS integration
• os-lang — Chinese localization updater
• os-lucky — Lucky network toolbox integration
• os-mihomo — Mihomo proxy integration
• os-pftop — pfTop diagnostics page
• os-sing-box — sing-box proxy integration
• os-staticarp — Static ARP binding integration
• os-ttyd — ttyd web terminal integration
• os-unboundcustom — Custom configuration options for Unbound DNS

Removing the repository
To remove the repository configuration:

Code Select Expand

rm -f /usr/local/etc/pkg/repos/opnwall.conf
pkg update -f
This removes only the repository configuration. It does not uninstall plugins that have already been installed.
Individual plugins can be removed from the OPNsense plugin page or with:

Code Select Expand

pkg delete <package-name>
Source code
The complete source code for all published plugins is available in the repository:
https://github.com/Opnwall/OPNsense-repo/tree/main/src

Each src/os-* directory is an independent plugin project and includes a build.sh script for building on a compatible OPNsense/FreeBSD system.
Bug reports, compatibility feedback and contributions are welcome:
https://github.com/Opnwall/OPNsense-repo/issues

Important notice
This is an independent community project. It is not affiliated with, maintained by, or officially supported by the OPNsense Project or Deciso B.V.
Before installing third-party plugins:

• Back up your OPNsense configuration.
• Test the packages in a non-production environment whenever possible.
• Verify compatibility after every major OPNsense upgrade.
• Proxy, DNS and DDNS plugins may change important network behavior, so review their configuration carefully.

Licenses for the source code and bundled third-party components are provided within the respective project directories.

OPNsense 自带了不少国外 DNS 服务商支持，例如 Cloudflare、GoDaddy、Route53 等，但国内常用的阿里云 DNS 和腾讯云 DNSPod 支持并不完整。为了方便国内用户使用，制作了DDNS补丁，在官方插件中增加了以下国内提供商：

aliyun：Aliyun DNS
tencentcloud：Tencent Cloud DNS
dnspodcn：保留原 DNSPod 中国服务名，并增强为支持自动新增记录

补丁安装后，可以在 Web 管理界面的 Dynamic DNS 页面中直接选择阿里云或腾讯云服务，填写 API 密钥、域名和主机记录，自动更新解析。




社区仓库:

Community Repository

项目地址:

DDNS-Patch

Link removed, please provide github link and not a pkg file.

GitHub link added.

[Installation method:]

When managing OPNsense firewalls, administrators often need to log in via SSH to execute commands, check logs, or perform advanced troubleshooting. While OPNsense offers a comprehensive WebGUI, a browser-integrated terminal is often more convenient for administrators accustomed to the command line. ttyd is a lightweight web terminal project that maps a local terminal to the browser, enabling a true web-based SSH experience. To simplify this process, I developed an OPNsense plugin that allows direct access to the system terminal via the browser after installation.



Installation method:

Code Select Expand

pkg add -f os-ttyd.pkg
Uninstallation method:

Code Select Expand

pkg delete os-ttyd.pkg
GitHub URL:
https://github.com/Opnwall/ttyd-for-OPNsense

Disclaimer:
Unofficial plugin; use at your own risk.

I am a translation contributor for the Chinese (zh-CN) language, and I have applied to join the translation team for the Chinese (TW) language.  My application was submitted some time ago, but it is still in a "pending" state.

Thanks, found it

I installed the new version and now pfTop works excellent, thanks a lot!

I apologise, I don't speak Chinese and that's why I write in English. But I wanted to test pfTop and gave your addon/tool a go (I did do a quick translation of your tool to English otherwise I would have been lost :) ).

After going to the page (pfTop) for the first time and no filter set:
You cannot view this attachment.

... and in pfTop if I set a filter the upper part of the dialog disappears and I can't press anything in the menu on the left.
You cannot view this attachment.

Btw: after installing it with install.sh you don't have to reboot. Delete the files /tmp/opnsense_acl_cache.json and /tmp/opnsense_menu_cache.xml and reload the webpage.

After updating to 25.7, these two files are gone. Is there any new way to refresh the menu without restarting?

Enter the filter content and press Enter to display the filtered content. Try entering udp and press Enter to display the ongoing upd.

Is there something wrong with the code I modified?

Hi, in didn't work with the 1st version either. If you look at the second picture in my first post, you can see the 'Excute command...'. That is all fine and I can adjust the filter, that is also fine.

But all the part above that is ('Sort By', 'States' etc) are not show when I apply a filter. And if I click on anything in the menu on the left, nothing happens.

I didn't expect you to reply so quickly.Re-download and test it.

I have modified my code, you can download it again and try it.

Thank you for your tip. I optimized the installation script and added the command to delete these two files, so that there is no need to restart the firewall. I also provide the English version of this tool.

other tools (english)

OPNsense自带中文语言包做不到完全覆盖，部分设置界面遗留有较多的未汉化词条。

主要有以下原因：

• 更新版本未及时更新词条；
• 附加软件包词条收录不全；
• 官方翻译模板收录词条不完整；
• 部分程序未使用多语言格式编写。

汉化方法：

安装在线汉化工具，点击开始更新完成汉化。

点击下载在线汉化工具

[下载：常用工具]

基于安全考虑，OPNsense未提供基于Web界面的Shell、pftop工具，以及对系统文件编辑功能，如果是高阶用户，知道如何防控使用风险，可以自行添加这些功能。
同时为方便对OPNsense进行补充汉化，也一并提供了在线汉化工具。

下载附件并解压缩，上传到防火墙，进入安装文件目录执行以下命令进行安装：

Code Select Expand

sh install.sh
安装完成刷新一下浏览器，然后导航到服务>其他工具菜单进行操作。


命令行工具


编辑文件


pftop工具


汉化工具


下载：常用工具

ddns-go是一个简单易用的DDNS，能自动更新域名解析到公网IP，支持 Alidns(阿里云)、 Dnspod(腾讯云)、 Cloudflare、华为云、 Callback、百度云、porkbun、GoDaddy、Google Domains。

社区仓库:

Community Repository

项目地址:

DDNS-Go