josh/jrouter
josh/jrouter
1
0
Fork 0
Code Issues 10 Pull requests Releases 1 Activity
**WIP** Home-grown alternative implementation of Apple Internet Router 3.0
228 commits 3 branches 1 tag 1.7 MiB
Go 99.8%
Dockerfile 0.2%
Find a file
Josh Deprez d25c2eb362
Send -> send
2024-05-12 18:31:01 +10:00
atalk generalise NBP FwdReq handling 2024-05-03 18:32:12 +10:00
aurp Fix Null event tuple coding 2024-05-12 12:08:33 +10:00
router Send -> send 2024-05-12 18:31:01 +10:00
status Tweak statuses 2024-04-26 13:59:21 +10:00
.gitignore Skip peers that don't resolve 2024-04-19 22:07:48 +10:00
go.mod WIP AppleTalk 2024-04-05 14:07:16 +11:00
go.sum WIP AppleTalk 2024-04-05 14:07:16 +11:00
jrouter.yaml Add peer list function 2024-04-21 15:14:16 +10:00
LICENSE Add LICENSE 2024-03-18 09:44:22 +11:00
main.go AURP peer timers in status 2024-05-12 18:07:27 +10:00
README.md Update README 2024-05-05 18:21:31 +10:00

README.md

jrouter

Home-grown alternative implementation of Apple Internet Router 3.0

Goals

  • Full compatibility with Apple Internet Router 3.0
  • Function on modern operating systems
  • EtherTalk support
  • Be observable (there's a HTTP server with a /status page)

TashTalk could be a stretch goal, if I can acquire one!

Things that used to be caveats

  • Previously it would listen for all EtherTalk traffic, regardless of destination. Now it doesn't do that, which should help it co-exist with other routers on the same host.
  • You can configure an alternate Ethernet address if you are reusing the same network interface for multiple different EtherTalk software.
  • In addition to the configured EtherTalk network and zone, it now learns routes and zones from other EtherTalk routers, and should share them across AURP.
  • There's a status server. Browse to http://[your router]:9459/status to see information about the state of jrouter.

Caveats

Things I plan to fix Real Soon Now:

  • Some packet types need splitting to fit within limits. Some of these aren't implemented yet (mainly encapsulated). The unimplemented ones seem unlikely to hit those limits unless you are running a lot of routers or zones locally.
  • I plan to add a Prometheus metrics endpoint and at least add log levels / verbosity config.
  • The AURP implementation is mostly there, but not fully complete. The main thing missing is sequence number checking.

Things I plan to fix At Some Point:

  • For expediency I made it act as a seed router. At some point I might add "soft seed" functionality.

How to use

WARNING: It Sorta Works™

First, set up a jrouter.yaml (use the one in this repo as an example).

TODO: explain the configuration file

Building and running:

sudo apt install libpcap-dev
go install gitea.drjosh.dev/josh/jrouter@latest
sudo setcap 'CAP_NET_BIND_SERVICE=ep CAP_NET_RAW=ep' ~/go/bin/jrouter
~/go/bin/jrouter
  • NET_BIND_SERVICE is needed to bind UDP port 387 (for talking between AIRs)
  • NET_RAW is needed for EtherTalk

TODO: instructions for non-Linux machines