Enum Exposure 

pub enum Exposure {
    Loopback,
    Internal {
        url: String,
    },
    Tailscale {
        url: String,
    },
    Public {
        url: String,
    },
}

Serialized form on disk uses an internal kind tag so the variant is explicit in the TOML — no guessing whether url = "foo.ts.net" implies Tailscale-mode or not.

Variants

Loopback

No public-facing URL. Service runs on http://127.0.0.1:<port> only — reachable from the host but nothing routes external traffic to it. Used for services that don’t need a domain (e.g. inbucket when the user only hits it via localhost).

Internal

LAN-only via Caddy at a *.internal hostname. Self-signed certs from Caddy’s internal CA — useful on a single machine where the user has imported ryra’s CA into their browser.

Fields

url: String

Tailscale

Exposed on the user’s tailnet at <service>.<tailnet>.ts.net via tailscale serve on the host. Real cert from the Tailscale-managed CA, no Caddyfile entry needed.

Fields

url: String

Public

A public hostname. Caddy is the reverse proxy when installed (LE or self-signed depending on tls.caddy); without Caddy, the user is fronting with their own proxy (Cloudflare Tunnel, nginx, etc.) and ryra leaves routing alone.

Fields

url: String

Implementations

impl Exposure

pub fn url(&self) -> Option<&str>

Browser-visible URL, if any. Convenient when something downstream is OK with Option<&str> (template context, OIDC redirects) and doesn’t care about the routing variant.

pub fn is_tailscale(&self) -> bool

True when this exposure is reached via tailscale serve instead of Caddy. Used to skip Caddyfile routes for *.ts.net URLs.

pub fn tailscale_svc_name(&self) -> Option<String>

For Tailscale exposures, the Tailscale Service name (the part after svc: — i.e. the first DNS label of the URL host). With per-host scoping this is <service>-<host> (e.g. vikunja-debian). Used by remove/reset paths to address the admin-API service definition without re-deriving the host from tailscale status (the URL was captured at install time, so renaming the host post-install doesn’t break teardown).

pub fn kind_str(&self) -> &'static str

Stable string form of the variant, for the exposure field in metadata.toml and reading it back. Mirrors the snake_case names used by serde’s tag = "kind" representation so the two stay in lockstep.

pub fn from_url(url: &str) -> Self

Classify a user-supplied URL string into the corresponding Exposure variant. *.internal → Internal, *.ts.net → Tailscale, anything else → Public. Used by the CLI when a raw --url <X> flag is passed.

Trait Implementations

impl Clone for Exposure

fn clone(&self) -> Exposure

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Exposure

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Exposure

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for Exposure

impl PartialEq for Exposure

fn eq(&self, other: &Exposure) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for Exposure

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for Exposure