Skip to content

jool: add Jool-based CLAT netifd proto#29070

Open
Gowee wants to merge 1 commit intoopenwrt:masterfrom
Gowee:jool_clat
Open

jool: add Jool-based CLAT netifd proto#29070
Gowee wants to merge 1 commit intoopenwrt:masterfrom
Gowee:jool_clat

Conversation

@Gowee
Copy link
Copy Markdown
Contributor

@Gowee Gowee commented Apr 5, 2026

📦 Package Details

Maintainer: @GoetzGoerisch @tiagogaspar8
(You can find this by checking the history of the package Makefile.)

Description:

Add a jool-clat-proto package that provides the jool_clat netifd proto helper for CLAT setups using Jool SIIT in a dedicated network namespace. This allows translation of traffic sourced from the router itself and more flexible routing, which are infeasible when running Jool SIIT directly because it hooks PREROUTING and processes traffic indiscriminately.


🧪 Run Testing Details

  • OpenWrt Version: 23.05.4
  • OpenWrt Target/Subtarget: mediatek/filogic
  • OpenWrt Device: CMCC RAX3000M

✅ Formalities

  • I have reviewed the CONTRIBUTING.md file for detailed contributing guidelines.

If your PR contains a patch:

  • It can be applied using git am
  • It has been refreshed to avoid offsets, fuzzes, etc., using
    make package/<your-package>/refresh V=s
  • It is structured in a way that it is potentially upstreamable
    (e.g., subject line, commit description, etc.)
    We must try to upstream patches to reduce maintenance burden.

@BKPepe BKPepe requested a review from Copilot April 5, 2026 12:06
Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Note

Copilot was unable to run its full agentic suite in this review.

Adds a new OpenWrt package providing a netifd protocol helper to run Jool SIIT CLAT inside a dedicated network namespace, plus documentation for configuring the new proto.

Changes:

  • Document the new jool_clat netifd proto and supported UCI options
  • Add jool_clat.sh proto helper that creates a netns + veth pair and configures Jool SIIT EAMT mappings
  • Add a new jool-clat-proto package to install the helper into /lib/netifd/proto

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated 5 comments.

File Description
net/jool/files/readme.md Documents jool_clat usage, examples, and supported options
net/jool/files/jool_clat.sh Implements the jool_clat netifd proto helper using netns + veth and Jool SIIT
net/jool/Makefile Introduces and installs the new jool-clat-proto package

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

@GoetzGoerisch
Copy link
Copy Markdown
Contributor

Thank you for this PR.
I have no operational experience in using Jool as SIIT.
My use case so far is using NAT64 (PLAT) mode.

Add a `jool-clat-proto` package that provides the `jool_clat` netifd
proto helper for CLAT setups using Jool SIIT in a dedicated network
namespace. This allows translation of traffic sourced from the router
itself and more flexible routing, which are infeasible when running Jool
SIIT directly because it hooks PREROUTING and processes traffic
indiscriminately. Check readme.md for usage example.

Signed-off-by: Hung-I Wang <whygowe@gmail.com>
Co-Authored-By: GPT 5.4 <codex@openai.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants