Skip to content

feat: add custom headers support for Komari instances#5

Open
ciallothu wants to merge 28 commits into
icylian:mainfrom
ciallothu:main
Open

feat: add custom headers support for Komari instances#5
ciallothu wants to merge 28 commits into
icylian:mainfrom
ciallothu:main

Conversation

@ciallothu

Copy link
Copy Markdown

Summary

This PR adds support for custom HTTP headers when connecting to Komari instances.

Users can now configure additional headers per instance, which will be attached to requests sent to the configured Komari server. This is useful for deployments protected by reverse proxies, gateway authentication, or access-control services such as Cloudflare Access, without making the feature specific to any single provider.

Motivation

Some Komari deployments are protected behind additional authentication layers. For example, Cloudflare Access requires non-browser clients to include service token headers:

  • CF-Access-Client-Id
  • CF-Access-Client-Secret

Previously, Yanami could not connect to these protected Komari instances because there was no way to attach custom headers to API requests. By adding generic custom header support, Yanami can work with Cloudflare Access as well as other self-hosted authentication gateways and reverse proxies.

Changes

  • Added custom headers configuration for Komari instances.
  • Headers are configured per instance.
  • Custom headers are attached to outgoing Komari requests.
  • The implementation is provider-agnostic and not limited to Cloudflare.
  • Sensitive header values can be used for access tokens, service tokens, or gateway authentication.

Example use cases

  • Cloudflare Access protected Komari instance.
  • Reverse proxy requiring custom authentication headers.
  • Internal gateway requiring API tokens.
  • Self-hosted access-control middleware in front of Komari.

Notes

This feature does not introduce any provider-specific logic. Cloudflare Access is only one supported use case through the generic custom headers mechanism.

ciallothu and others added 20 commits May 10, 2026 19:57
- Move all Android files to android/ folder
- Rewrite iOS app using MVVM and SwiftData
- Align iOS features with Android (Server management, Node details, Terminal snippets, Auto-refresh)
- Update CI workflows to use dynamic pre-release tags based on branch push
…WebSocket connection, and add Snippet management UI
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.

2 participants