Compare commits
1 Commits
| Author | SHA1 | Date | |
|---|---|---|---|
| be0e622333 |
@@ -16,7 +16,7 @@ when:
|
|||||||
|
|
||||||
steps:
|
steps:
|
||||||
- name: Build all arches (no push)
|
- name: Build all arches (no push)
|
||||||
image: woodpeckerci/plugin-docker-buildx:6.1.0
|
image: woodpeckerci/plugin-docker-buildx:5.2.2
|
||||||
privileged: true
|
privileged: true
|
||||||
settings:
|
settings:
|
||||||
repo: mikrotik-tailscale
|
repo: mikrotik-tailscale
|
||||||
|
|||||||
@@ -34,7 +34,7 @@ steps:
|
|||||||
- bao kv get -mount secret -field RENOVATE_TOKEN renovate > /woodpecker/git_token
|
- bao kv get -mount secret -field RENOVATE_TOKEN renovate > /woodpecker/git_token
|
||||||
|
|
||||||
- name: Auto-tag mt.1 on Tailscale bump
|
- name: Auto-tag mt.1 on Tailscale bump
|
||||||
image: alpine/git:v2.52.0
|
image: alpine/git:2.49.1
|
||||||
environment:
|
environment:
|
||||||
CI_REPO_URL: https://gitea.lumpiasty.xyz/lumpiasty/mikrotik-tailscale.git
|
CI_REPO_URL: https://gitea.lumpiasty.xyz/lumpiasty/mikrotik-tailscale.git
|
||||||
commands:
|
commands:
|
||||||
|
|||||||
@@ -43,7 +43,7 @@ steps:
|
|||||||
- 'printf "PLUGIN_PASSWORD=%s\n" "$(bao kv get -mount secret -field REGISTRY_PASSWORD container-registry)" >> /woodpecker/registry.env'
|
- 'printf "PLUGIN_PASSWORD=%s\n" "$(bao kv get -mount secret -field REGISTRY_PASSWORD container-registry)" >> /woodpecker/registry.env'
|
||||||
|
|
||||||
- name: Build and push multi-arch image
|
- name: Build and push multi-arch image
|
||||||
image: woodpeckerci/plugin-docker-buildx:6.1.0
|
image: woodpeckerci/plugin-docker-buildx:5.2.2
|
||||||
privileged: true
|
privileged: true
|
||||||
settings:
|
settings:
|
||||||
registry: gitea.lumpiasty.xyz
|
registry: gitea.lumpiasty.xyz
|
||||||
|
|||||||
@@ -46,7 +46,7 @@ steps:
|
|||||||
- bao kv get -mount secret -field GITHUB_COM_TOKEN renovate > /woodpecker/github_com_token
|
- bao kv get -mount secret -field GITHUB_COM_TOKEN renovate > /woodpecker/github_com_token
|
||||||
- name: renovate
|
- name: renovate
|
||||||
# Renovate's built-in "woodpecker" manager tracks this image automatically.
|
# Renovate's built-in "woodpecker" manager tracks this image automatically.
|
||||||
image: renovate/renovate:43.207.4
|
image: renovate/renovate:43.205.2
|
||||||
environment:
|
environment:
|
||||||
# --- platform / target ---
|
# --- platform / target ---
|
||||||
RENOVATE_PLATFORM: gitea
|
RENOVATE_PLATFORM: gitea
|
||||||
|
|||||||
+4
-31
@@ -21,8 +21,8 @@
|
|||||||
# =============================================================================
|
# =============================================================================
|
||||||
FROM --platform=$BUILDPLATFORM golang:1.26.3-alpine@sha256:91eda9776261207ea25fd06b5b7fed8d397dd2c0a283e77f2ab6e91bfa71079d AS builder
|
FROM --platform=$BUILDPLATFORM golang:1.26.3-alpine@sha256:91eda9776261207ea25fd06b5b7fed8d397dd2c0a283e77f2ab6e91bfa71079d AS builder
|
||||||
|
|
||||||
# renovate: datasource=github-releases depName=tailscale packageName=tailscale/tailscale versioning=semver
|
# renovate: datasource=github-releases depName=tailscale packageName=tailscale/tailscale
|
||||||
ARG TAILSCALE_VERSION=v1.98.5
|
ARG TAILSCALE_VERSION=v1.98.3
|
||||||
|
|
||||||
# Provided automatically by buildx for the target platform.
|
# Provided automatically by buildx for the target platform.
|
||||||
ARG TARGETOS
|
ARG TARGETOS
|
||||||
@@ -69,12 +69,6 @@ WORKDIR /src/tailscale
|
|||||||
# trusted unix socket, so PermitRead/PermitWrite are
|
# trusted unix socket, so PermitRead/PermitWrite are
|
||||||
# always false and EVERY CLI call (status, up, set, ...)
|
# always false and EVERY CLI call (status, up, set, ...)
|
||||||
# returns "access denied" (tailscale/tailscale#17873).
|
# returns "access denied" (tailscale/tailscale#17873).
|
||||||
# ipnbus — IPN bus watch. Without it, 'tailscale up' cannot wait
|
|
||||||
# for completion: it fires config at the daemon and
|
|
||||||
# returns immediately ("built with ts_omit_ipnbus; not
|
|
||||||
# waiting for completion") WITHOUT printing the auth URL
|
|
||||||
# or confirming success. Including it makes interactive
|
|
||||||
# 'up' behave normally (blocks, prints login URL).
|
|
||||||
#
|
#
|
||||||
# Everything else remains omitted, including (rationale):
|
# Everything else remains omitted, including (rationale):
|
||||||
# clientupdate — DELIBERATELY removed. The built-in updater would download
|
# clientupdate — DELIBERATELY removed. The built-in updater would download
|
||||||
@@ -117,7 +111,6 @@ RUN mkdir -p /out && \
|
|||||||
-e 's/ts_omit_health,\{0,1\}//g' \
|
-e 's/ts_omit_health,\{0,1\}//g' \
|
||||||
-e 's/ts_omit_iptables,\{0,1\}//g' \
|
-e 's/ts_omit_iptables,\{0,1\}//g' \
|
||||||
-e 's/ts_omit_unixsocketidentity,\{0,1\}//g' \
|
-e 's/ts_omit_unixsocketidentity,\{0,1\}//g' \
|
||||||
-e 's/ts_omit_ipnbus,\{0,1\}//g' \
|
|
||||||
-e 's/,$//' \
|
-e 's/,$//' \
|
||||||
) && \
|
) && \
|
||||||
echo "Build tags: ${TAGS}" && \
|
echo "Build tags: ${TAGS}" && \
|
||||||
@@ -157,24 +150,6 @@ RUN mkdir -p /out/usrlocalbin && \
|
|||||||
ln -s /usr/local/bin/tailscale.combined /out/usrlocalbin/tailscale && \
|
ln -s /usr/local/bin/tailscale.combined /out/usrlocalbin/tailscale && \
|
||||||
ln -s /usr/local/bin/tailscale.combined /out/usrlocalbin/tailscaled
|
ln -s /usr/local/bin/tailscale.combined /out/usrlocalbin/tailscaled
|
||||||
|
|
||||||
# Entrypoint wrapper: enable IP forwarding inside the container's network
|
|
||||||
# namespace, then exec tailscaled. tailscaled does NOT reliably enable IPv6
|
|
||||||
# forwarding itself in a container netns ("IPv6 forwarding is disabled" warning),
|
|
||||||
# which silently breaks advertised IPv6 subnet routes. The sysctls ARE writable
|
|
||||||
# from inside a RouterOS container, so we set both here. Written in the builder
|
|
||||||
# stage so it ships in the same single /usr/local/bin COPY layer (preserves the
|
|
||||||
# overlayfs single-copy property). `exec` keeps tailscaled as PID 1.
|
|
||||||
RUN printf '%s\n' \
|
|
||||||
'#!/bin/sh' \
|
|
||||||
'# Enable IPv4/IPv6 forwarding. Required for advertised subnet routes and' \
|
|
||||||
'# exit-node functionality.' \
|
|
||||||
'for f in /proc/sys/net/ipv4/ip_forward /proc/sys/net/ipv6/conf/all/forwarding; do' \
|
|
||||||
' if [ -w "$f" ]; then echo 1 > "$f" 2>/dev/null || echo "warn: could not write $f"; fi' \
|
|
||||||
'done' \
|
|
||||||
'exec /usr/local/bin/tailscaled "$@"' \
|
|
||||||
> /out/usrlocalbin/entrypoint.sh && \
|
|
||||||
chmod +x /out/usrlocalbin/entrypoint.sh
|
|
||||||
|
|
||||||
# =============================================================================
|
# =============================================================================
|
||||||
# Stage 2: Custom minimal busybox
|
# Stage 2: Custom minimal busybox
|
||||||
# =============================================================================
|
# =============================================================================
|
||||||
@@ -196,7 +171,7 @@ RUN printf '%s\n' \
|
|||||||
# This stage runs on the TARGET platform (no --platform override): gcc then
|
# This stage runs on the TARGET platform (no --platform override): gcc then
|
||||||
# produces native target-arch binaries directly. Under buildx this is
|
# produces native target-arch binaries directly. Under buildx this is
|
||||||
# transparently emulated via binfmt/QEMU for non-native targets.
|
# transparently emulated via binfmt/QEMU for non-native targets.
|
||||||
FROM alpine:3.23.4@sha256:5b10f432ef3da1b8d4c7eb6c487f2f5a8f096bc91145e68878dd4a5019afde11 AS busybox
|
FROM alpine:3.21.7@sha256:48b0309ca019d89d40f670aa1bc06e426dc0931948452e8491e3d65087abc07d AS busybox
|
||||||
|
|
||||||
# renovate: datasource=docker depName=busybox versioning=docker
|
# renovate: datasource=docker depName=busybox versioning=docker
|
||||||
ARG BUSYBOX_VERSION=1.37.0
|
ARG BUSYBOX_VERSION=1.37.0
|
||||||
@@ -292,9 +267,7 @@ ENV PATH=/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin
|
|||||||
# -----------------------------------------------------------------------------
|
# -----------------------------------------------------------------------------
|
||||||
VOLUME ["/var/lib/tailscale"]
|
VOLUME ["/var/lib/tailscale"]
|
||||||
|
|
||||||
# entrypoint.sh enables IP forwarding (incl. IPv6) in the container netns, then
|
ENTRYPOINT ["/usr/local/bin/tailscaled"]
|
||||||
# exec's tailscaled with the CMD flags below as its arguments.
|
|
||||||
ENTRYPOINT ["/usr/local/bin/entrypoint.sh"]
|
|
||||||
|
|
||||||
# Default flags:
|
# Default flags:
|
||||||
# --no-logs-no-support disables logtail uploads (logtail binary code is
|
# --no-logs-no-support disables logtail uploads (logtail binary code is
|
||||||
|
|||||||
@@ -7,8 +7,6 @@ A minimal Tailscale Docker image built for MikroTik routers running
|
|||||||
16 MB internal flash. Built from source with only router-relevant features
|
16 MB internal flash. Built from source with only router-relevant features
|
||||||
included.
|
included.
|
||||||
|
|
||||||
> Disclaimer: This project has been largely vibe-coded, but I stand behind design and implementation choices made.
|
|
||||||
|
|
||||||
- **~4 MB** extracted rootfs (`FROM scratch` + UPX'd Tailscale binary + a custom
|
- **~4 MB** extracted rootfs (`FROM scratch` + UPX'd Tailscale binary + a custom
|
||||||
static busybox debug shell).
|
static busybox debug shell).
|
||||||
- **Multi-arch**: amd64, arm64, arm/v7 — one tag, RouterOS pulls the right one.
|
- **Multi-arch**: amd64, arm64, arm/v7 — one tag, RouterOS pulls the right one.
|
||||||
@@ -18,23 +16,6 @@ included.
|
|||||||
- **Flash-wear conscious**: minimal persistent state, no netmap disk-caching,
|
- **Flash-wear conscious**: minimal persistent state, no netmap disk-caching,
|
||||||
tmpfs for scratch and runtime.
|
tmpfs for scratch and runtime.
|
||||||
|
|
||||||
## Motivation
|
|
||||||
|
|
||||||
There is no built-in Tailscale integration in MikroTik, and other solutions
|
|
||||||
feel underwhelming. I've used Fluent-networks' tailscale-mikrotik until now,
|
|
||||||
but that basically forced me to connect external storage to my router
|
|
||||||
just to use Tailscale. This approach, while works, is fragile, wasteful
|
|
||||||
and overcomplicated, so I decided to do better one myself.
|
|
||||||
|
|
||||||
| | **This project** | Fluent-networks/tailscale-mikrotik |
|
|
||||||
|---|---|---|
|
|
||||||
| Size | **~4 MB** | ~106 MB |
|
|
||||||
| Size reduction technique | **Minimal container with custom Tailscale and Busybox builds, compressed by UPX** | Alpine Linux base, Tailscale binary compressed by UPX on build, but auto-update completely nullifies that on first launch |
|
|
||||||
| Update mechanism | **Automatically released optimized container images with new Tailscale versions, scheduled script updating deployment on new version** | None, opt-in Tailscale built-in auto-update downloading official binaries |
|
|
||||||
| Flash wear | **Write-heavy functionality compiled out, suitable for low-endurance flash chips** | High, constant netmap cache updates |
|
|
||||||
| Stability | **Immutable container** | Tailscale app can update on its own |
|
|
||||||
| Features | **Only router-useful Tailscale features compiled, Busybox providing shell and utils** | Full tailscale, OpenSSH server, Bash, IPTables |
|
|
||||||
|
|
||||||
## Documentation
|
## Documentation
|
||||||
|
|
||||||
- **[Usage](docs/USAGE.md)** — deploy the published image on a MikroTik router
|
- **[Usage](docs/USAGE.md)** — deploy the published image on a MikroTik router
|
||||||
|
|||||||
+2
-16
@@ -70,21 +70,8 @@ in a future release stays omitted until deliberately added to the Dockerfile.
|
|||||||
saves a real ~195 kB of flash (424 kB → 229 kB), not just transfer size.
|
saves a real ~195 kB of flash (424 kB → 229 kB), not just transfer size.
|
||||||
|
|
||||||
The final image is built `FROM scratch` — there is no base distro layer.
|
The final image is built `FROM scratch` — there is no base distro layer.
|
||||||
It contains only the busybox binary + applet symlinks, the CA bundle, the
|
It contains only the busybox binary + applet symlinks, the CA bundle, and
|
||||||
Tailscale binary, and a tiny `entrypoint.sh`.
|
the Tailscale binary.
|
||||||
|
|
||||||
### Entrypoint: IP forwarding
|
|
||||||
|
|
||||||
`ENTRYPOINT` is a small `entrypoint.sh` that enables IPv4 and IPv6 forwarding
|
|
||||||
(`net.ipv4.ip_forward`, `net.ipv6.conf.all.forwarding`) in the container's
|
|
||||||
network namespace, then `exec`s `tailscaled` (so the daemon stays PID 1). This
|
|
||||||
is necessary because `tailscaled` does **not** reliably enable IPv6 forwarding
|
|
||||||
itself inside a container netns — it logs "IPv6 forwarding is disabled" and
|
|
||||||
advertised IPv6 subnet routes silently fail. The sysctls are writable from
|
|
||||||
inside a RouterOS container, so the entrypoint sets them directly; no
|
|
||||||
host-side or `/container` configuration is required. The script is created in
|
|
||||||
the builder stage so it ships in the same single `/usr/local/bin` `COPY` layer
|
|
||||||
(preserving the [single-copy property](#avoiding-overlayfs-layer-duplication)).
|
|
||||||
|
|
||||||
### Avoiding overlayfs layer duplication
|
### Avoiding overlayfs layer duplication
|
||||||
|
|
||||||
@@ -156,7 +143,6 @@ that's a separate build, not just a `--platform` change.
|
|||||||
| iptables | Linux iptables support for routing rules |
|
| iptables | Linux iptables support for routing rules |
|
||||||
| osrouter | Configure kernel network stack and routing tables |
|
| osrouter | Configure kernel network stack and routing tables |
|
||||||
| unixsocketidentity | **Required** — without it the localapi denies every CLI call with "access denied" ([tailscale#17873](https://github.com/tailscale/tailscale/issues/17873)) |
|
| unixsocketidentity | **Required** — without it the localapi denies every CLI call with "access denied" ([tailscale#17873](https://github.com/tailscale/tailscale/issues/17873)) |
|
||||||
| ipnbus | Lets `tailscale up` wait for completion and print the login URL; without it `up` returns immediately without confirming success |
|
|
||||||
|
|
||||||
## Features intentionally omitted
|
## Features intentionally omitted
|
||||||
|
|
||||||
|
|||||||
+48
-42
@@ -10,58 +10,64 @@ reasoning behind these choices, see [DESIGN.md](DESIGN.md).
|
|||||||
## Deploy on MikroTik (RouterOS)
|
## Deploy on MikroTik (RouterOS)
|
||||||
|
|
||||||
Verified on RouterOS 7.21.2 (arm64, CRS418). Commands are grouped into
|
Verified on RouterOS 7.21.2 (arm64, CRS418). Commands are grouped into
|
||||||
copy-paste blocks, defaults should fit most configurations.
|
copy-paste blocks; **only the values marked `CHANGE ME` need editing**.
|
||||||
|
|
||||||
> Because the image has no built-in updater (the `clientupdate` feature is
|
> Because the image has no built-in updater (the `clientupdate` feature is
|
||||||
> [intentionally compiled out](DESIGN.md#why-the-built-in-updater-is-removed)),
|
> [intentionally compiled out](DESIGN.md#why-the-built-in-updater-is-removed)),
|
||||||
> updates are handled by a small script that recreates container when
|
> updates are handled by a small script that only re-pulls when the published
|
||||||
> the update is published — see [step 7](#7-enable-automatic-updates).
|
> image actually changed — see [step 7](#7-enable-automatic-updates).
|
||||||
|
|
||||||
### 0. Prerequisites
|
### 0. Prerequisites
|
||||||
|
|
||||||
- RouterOS >7.13 with the **container** package installed.
|
- RouterOS 7.x with the **container** package installed.
|
||||||
- Container mode enabled ([documentation](https://manual.mikrotik.com/docs/System%20Information%20and%20Utilities/device-mode/#changing-mode-of-device-mode)):
|
- Container mode enabled (needs physical access — press reset / cold-boot when
|
||||||
|
prompted):
|
||||||
|
|
||||||
```
|
```
|
||||||
/system/device-mode/update container=yes
|
/system/device-mode/update container=yes
|
||||||
```
|
```
|
||||||
|
|
||||||
### 1. Networking (veth + routing)
|
- A Tailscale **auth key** from the admin console
|
||||||
|
(**Settings → Keys**, reusable, optionally tagged). You'll use it in step 6.
|
||||||
|
|
||||||
Gives the container an internal IP and configures routing to the tailnet.
|
### 1. Networking (veth + bridge + NAT)
|
||||||
Pick a subnet that doesn't clash with your LAN.
|
|
||||||
|
Gives the container an internal IP and outbound internet via NAT. Pick a subnet
|
||||||
|
that doesn't clash with your LAN.
|
||||||
|
|
||||||
```
|
```
|
||||||
/interface/veth/add name=veth-tailscale address=172.20.0.2/24 gateway=172.20.0.1
|
/interface/veth/add name=veth-tailscale address=172.20.0.2/24 gateway=172.20.0.1
|
||||||
/interface/bridge/add name=containers
|
/interface/bridge/add name=containers
|
||||||
/ip/address/add address=172.20.0.1/24 interface=containers
|
/ip/address/add address=172.20.0.1/24 interface=containers
|
||||||
/interface/bridge/port/add bridge=containers interface=veth-tailscale
|
/interface/bridge/port/add bridge=containers interface=veth-tailscale
|
||||||
/ip/route/add dst-address=100.64.0.0/10 gateway=172.20.0.2 comment=Tailnet
|
/ip/firewall/nat/add chain=srcnat action=masquerade src-address=172.20.0.0/24
|
||||||
```
|
```
|
||||||
|
|
||||||
If you want the router to have access to subnets shared by other tailscale nodes,
|
|
||||||
add route for each one.
|
|
||||||
|
|
||||||
```
|
|
||||||
/ip/route/add dst-address=[subnet CIDR] gateway=172.20.0.2 comment="Another network via tailscale"
|
|
||||||
```
|
|
||||||
|
|
||||||
If you want to share your LAN via tailscale, add it as an advertised route in
|
|
||||||
[step 5](#5-authenticate). You may also need additional firewall configuration
|
|
||||||
to accept connections to or from tailnet if you have one configured.
|
|
||||||
You should not need any additional NAT rules.
|
|
||||||
|
|
||||||
### 2. Extraction scratch dir (tmpfs)
|
### 2. Extraction scratch dir (tmpfs)
|
||||||
|
|
||||||
Put the image extraction scratch dir on **tmpfs** (RAM) so the pull/extract
|
Put the image extraction scratch dir on **tmpfs** (RAM) so the pull/extract
|
||||||
happen in RAM and doesn't fill up or wear out flash:
|
never writes to flash:
|
||||||
|
|
||||||
```
|
```
|
||||||
/disk/add type=tmpfs tmpfs-max-size=256M slot=tmp
|
/disk/add type=tmpfs tmpfs-max-size=256M slot=tmp
|
||||||
/container/config/set tmpdir=tmp
|
/container/config/set tmpdir=tmp
|
||||||
```
|
```
|
||||||
|
|
||||||
### 3. Persistent state mount (the only thing on flash)
|
> **No `registry-url` change needed.** This guide puts the full registry host in
|
||||||
|
> `remote-image` (step 5), and RouterOS pulls directly from that host — the
|
||||||
|
> global `registry-url` is ignored when the image reference includes a host.
|
||||||
|
> This is intentional: it leaves your existing `registry-url` untouched, so
|
||||||
|
> other containers (e.g. ones pulling from Docker Hub or ghcr.io) keep working,
|
||||||
|
> and multiple registries can be used side by side.
|
||||||
|
|
||||||
|
### 3. Authentication note (no env needed)
|
||||||
|
|
||||||
|
This image runs `tailscaled` directly and does **not** bundle Tailscale's
|
||||||
|
`containerboot` wrapper, so the `TS_AUTHKEY` environment variable is **not**
|
||||||
|
read automatically. You authenticate with `tailscale up --authkey=...` after the
|
||||||
|
container starts (step 6) — this keeps the image minimal and needs no env list.
|
||||||
|
|
||||||
|
### 4. Persistent state mount (the only thing on flash)
|
||||||
|
|
||||||
Only the tiny `tailscaled.state` (node identity / key) needs to persist. Mount
|
Only the tiny `tailscaled.state` (node identity / key) needs to persist. Mount
|
||||||
just that directory:
|
just that directory:
|
||||||
@@ -70,7 +76,14 @@ just that directory:
|
|||||||
/container/mounts/add list=tailscale_state src=tailscale/state dst=/var/lib/tailscale
|
/container/mounts/add list=tailscale_state src=tailscale/state dst=/var/lib/tailscale
|
||||||
```
|
```
|
||||||
|
|
||||||
### 4. Add and start the container
|
`src=tailscale/state` is on internal storage. This holds `tailscaled.state`
|
||||||
|
(and `derpmap.cached.json`), written only on auth / key rotation / prefs
|
||||||
|
change — **not** on every netmap update, because netmap disk-caching is omitted
|
||||||
|
([why](DESIGN.md#why-netmap-disk-caching-is-removed)). Flash wear is therefore
|
||||||
|
minimal. If you want *zero* persistent writes, point `src` at a tmpfs disk slot
|
||||||
|
instead and accept re-authentication after a reboot.
|
||||||
|
|
||||||
|
### 5. Add and start the container
|
||||||
|
|
||||||
```
|
```
|
||||||
/container/add \
|
/container/add \
|
||||||
@@ -93,25 +106,16 @@ Wait for the pull/extract to finish (`status=stopped`), then start it:
|
|||||||
|
|
||||||
The daemon is now running but **not yet authenticated**.
|
The daemon is now running but **not yet authenticated**.
|
||||||
|
|
||||||
### 5. Authenticate
|
### 6. Authenticate
|
||||||
|
|
||||||
> This image runs `tailscaled` via a tiny entrypoint (which enables IP
|
Enter the container shell and bring Tailscale up with your auth key. You can set
|
||||||
forwarding, then `exec`s the daemon) and does **not** bundle Tailscale's
|
subnet routes / exit-node advertisement in the same command:
|
||||||
`containerboot` wrapper, so the `TS_AUTHKEY` environment variable is **not**
|
|
||||||
read automatically. You authenticate with `tailscale up --authkey=...` after the
|
|
||||||
container starts.
|
|
||||||
|
|
||||||
Enter the container shell and bring Tailscale up with your auth key.
|
|
||||||
Use `tailscale up --help` to see list of commands, customize it to your needs,
|
|
||||||
add subnets (eg. your LAN) or exit-node advertisements in command below.
|
|
||||||
|
|
||||||
```
|
```
|
||||||
/container/shell [find where name=tailscale]
|
/container/shell [find where name=tailscale]
|
||||||
# inside the container — CHANGE ME: your key (and adjust routes/subnet):
|
# inside the container — CHANGE ME: your key (and adjust routes/subnet):
|
||||||
tailscale up --authkey=tskey-auth-CHANGEME \
|
tailscale up --authkey=tskey-auth-CHANGEME \
|
||||||
--accept-routes \
|
--advertise-routes=192.168.88.0/24 \
|
||||||
--snat-subnet-routes=false \
|
|
||||||
--advertise-routes=172.20.0.0/24 \
|
|
||||||
--advertise-exit-node
|
--advertise-exit-node
|
||||||
exit
|
exit
|
||||||
```
|
```
|
||||||
@@ -120,7 +124,7 @@ The node now appears in your Tailscale admin console. Approve the advertised
|
|||||||
routes / exit node there. Because the auth state is written to the persisted
|
routes / exit node there. Because the auth state is written to the persisted
|
||||||
`tailscaled.state`, you only do this once — it survives reboots and updates.
|
`tailscaled.state`, you only do this once — it survives reboots and updates.
|
||||||
|
|
||||||
### 6. Enable automatic updates
|
### 7. Enable automatic updates
|
||||||
|
|
||||||
First, edit the `CONFIG` block at the top of `routeros/update-tailscale.rsc` if
|
First, edit the `CONFIG` block at the top of `routeros/update-tailscale.rsc` if
|
||||||
you changed any names in the steps above. The defaults match this guide
|
you changed any names in the steps above. The defaults match this guide
|
||||||
@@ -132,6 +136,8 @@ create a **named script** from it and schedule it:
|
|||||||
|
|
||||||
```
|
```
|
||||||
# Create the named script from the uploaded file's contents.
|
# Create the named script from the uploaded file's contents.
|
||||||
|
# (Do NOT use `/import` — that just runs the file once and does not create a
|
||||||
|
# reusable script for the scheduler to call.)
|
||||||
/system/script/add name=update-tailscale source=[/file/get update-tailscale.rsc contents]
|
/system/script/add name=update-tailscale source=[/file/get update-tailscale.rsc contents]
|
||||||
|
|
||||||
# Run it daily.
|
# Run it daily.
|
||||||
@@ -173,14 +179,14 @@ queries to Tailscale's magic DNS resolver:
|
|||||||
add name="ts.net" type=FWD forward-to=100.100.100.100 match-subdomain=yes
|
add name="ts.net" type=FWD forward-to=100.100.100.100 match-subdomain=yes
|
||||||
```
|
```
|
||||||
|
|
||||||
When this is configured, you can connect to other tailscale machines using
|
This avoids writing to `/etc/resolv.conf` inside the container (which would
|
||||||
`[device name].[tailnet name].ts.net`. You can see and change assigned
|
happen if `--accept-dns` is passed to `tailscale up`). The container resolves
|
||||||
Tailnet DNS name in Tailscale admin panel under DNS tab.
|
Tailscale node names; the rest of the router uses its own DNS.
|
||||||
|
|
||||||
## Updating
|
## Updating
|
||||||
|
|
||||||
You don't normally do anything: when a new release is published, the
|
You don't normally do anything: when a new release is published, the
|
||||||
auto-update script ([step 6](#6-enable-automatic-updates)) detects the changed
|
auto-update script ([step 7](#7-enable-automatic-updates)) detects the changed
|
||||||
`:stable` image on its next scheduled run and recreates the container. Your
|
`:stable` image on its next scheduled run and recreates the container. Your
|
||||||
node identity and settings persist across the update via the state mount.
|
node identity and settings persist across the update via the state mount.
|
||||||
|
|
||||||
|
|||||||
+5
-22
@@ -7,17 +7,6 @@
|
|||||||
],
|
],
|
||||||
"labels": ["dependencies"],
|
"labels": ["dependencies"],
|
||||||
"rebaseWhen": "behind-base-branch",
|
"rebaseWhen": "behind-base-branch",
|
||||||
"customManagers": [
|
|
||||||
{
|
|
||||||
"customType": "regex",
|
|
||||||
"description": "Update version ARGs annotated with a `# renovate:` comment (the dockerfile manager only handles FROM/image lines, not ARG values).",
|
|
||||||
"managerFilePatterns": ["/(^|/)Dockerfile$/"],
|
|
||||||
"matchStrings": [
|
|
||||||
"#\\s*renovate:\\s*datasource=(?<datasource>\\S+)\\s+depName=(?<depName>\\S+)(?:\\s+packageName=(?<packageName>\\S+))?(?:\\s+versioning=(?<versioning>\\S+))?\\s+ARG \\w+=(?<currentValue>\\S+)"
|
|
||||||
],
|
|
||||||
"matchStringsStrategy": "any"
|
|
||||||
}
|
|
||||||
],
|
|
||||||
"packageRules": [
|
"packageRules": [
|
||||||
{
|
{
|
||||||
"matchManagers": ["dockerfile"],
|
"matchManagers": ["dockerfile"],
|
||||||
@@ -27,8 +16,9 @@
|
|||||||
{
|
{
|
||||||
"matchDatasources": ["github-releases"],
|
"matchDatasources": ["github-releases"],
|
||||||
"matchPackageNames": ["tailscale/tailscale"],
|
"matchPackageNames": ["tailscale/tailscale"],
|
||||||
"description": "TAILSCALE_VERSION ARG: only stable releases. Tailscale uses EVEN minor versions for stable (v1.98.x); ODD minors (v1.99.x) are unstable, so filter to even minors and ignore pre-releases. The `v` prefix is kept (no extractVersion) so the ARG value stays v-prefixed to match the git tags cloned in the Dockerfile.",
|
"description": "TAILSCALE_VERSION ARG: only stable releases. Tailscale uses EVEN minor versions for stable (v1.98.x); ODD minors (v1.99.x) are unstable, so filter to even minors and ignore pre-releases.",
|
||||||
"allowedVersions": "/^v\\d+\\.\\d*[02468]\\.\\d+$/",
|
"extractVersion": "^v(?<version>\\d+\\.\\d+\\.\\d+)$",
|
||||||
|
"allowedVersions": "/^\\d+\\.\\d*[02468]\\.\\d+$/",
|
||||||
"ignoreUnstable": true
|
"ignoreUnstable": true
|
||||||
},
|
},
|
||||||
{
|
{
|
||||||
@@ -40,15 +30,8 @@
|
|||||||
},
|
},
|
||||||
{
|
{
|
||||||
"matchManagers": ["dockerfile"],
|
"matchManagers": ["dockerfile"],
|
||||||
"matchPackageNames": ["golang", "alpine"],
|
"matchPackageNames": ["golang", "alpine", "busybox"],
|
||||||
"description": "Automerge PATCH-only bumps of build components (Go/Alpine) once the PR build passes; review minor/major manually.",
|
"description": "Automerge PATCH-only bumps of build components (Go/Alpine/busybox) once the PR build passes; review minor/major manually.",
|
||||||
"matchUpdateTypes": ["patch"],
|
|
||||||
"automerge": true
|
|
||||||
},
|
|
||||||
{
|
|
||||||
"matchDatasources": ["docker"],
|
|
||||||
"matchPackageNames": ["busybox"],
|
|
||||||
"description": "busybox ARG (custom manager): automerge PATCH bumps once the PR build passes; review minor/major manually.",
|
|
||||||
"matchUpdateTypes": ["patch"],
|
"matchUpdateTypes": ["patch"],
|
||||||
"automerge": true
|
"automerge": true
|
||||||
},
|
},
|
||||||
|
|||||||
Reference in New Issue
Block a user