oeHostsApp 한국어

Hosts profiles for Chrome,
local HTTPS proxy,
live traffic — in one window.

Point domains at the servers you choose while you develop and test.
No need to edit your system hosts file.

Download View on GitHub

Latest 0.2.0 MIT license · Windows · macOS · Linux · Java 21+

The oeHosts tab

Features

One window, three tabs — oeHosts, oeProxy and Network — built for a single user.

oeHosts

Create hosts profiles, organize them in folders, and merge the ones you pick. Launch Chrome and the selected profiles are passed as --host-resolver-rules to that Chrome only. Your system hosts file stays untouched.

oeProxy

Describe virtual hosts in YAML to route domains and paths to backends. The built-in reverse proxy runs on HTTPS (port 443), issues a certificate per domain automatically, and applies changes as soon as you save.

Network

See every request and response passing through the built-in proxy, live: headers, cookies, bodies and WebSocket frames.

Phones and other tools

Apply the same hosts to a phone browser through the proxy service and install the CA certificate from a QR code. Share a profile as a URL to subscribe to in hosts managers that support remote sources, or apply it to JVM apps with the Java agent.

Demo video

See profile switching, launching Chrome and setting up the proxy in one go.

Screens

The oeHosts tab
oeHosts — switch profiles on, pick Chrome options and launch. The right side previews the exact rules that will be passed.
The oeProxy tab
oeProxy — enabled virtual hosts are merged and appear in the routes on the right immediately.

Install

The install script downloads the latest release jar, verifies its checksum and creates a shortcut. Once installed, you can update from inside the app.

Run in PowerShell. Adds a Start menu shortcut and an entry under Settings → Apps.

irm https://raw.githubusercontent.com/tricatch/oeHostsApp/master/install.ps1 | iex

View the script

Run in a terminal. Creates the ~/.local/bin/oehostsapp command and, on macOS, oeHostsApp.app in your Applications folder.

curl -fsSL https://raw.githubusercontent.com/tricatch/oeHostsApp/master/install.sh | sh

View the script

Run

oehostsapp

Download oehostsapp.jar from the release and run it.

Download oehostsapp.jar (0.2.0)

java -jar oehostsapp.jar

To use a separate data folder

java -jar oehostsapp.jar --data ~/oehostsapp-data

Requirements

  • Java 21 or later — Windows: winget install EclipseAdoptium.Temurin.21.JRE, macOS: brew install openjdk, Linux: sudo apt install openjdk-21-jre (or your distribution's package manager)
  • Google Chrome — the app launches Chrome itself.

Unsigned executables are blocked by Windows Smart App Control and similar protections, so the app runs as a jar on your installed Java.

Quick start

Route dev.example.com to a local dev server and open it in Chrome.

  1. Trust the CA certificate

    In Settings → oeProxy → CA certificate, add it to the trust store. Only needed once.

  2. Create a virtual host

    On the oeProxy tab, press +, write the domain and backend in YAML, and switch it on.

  3. Create a hosts profile

    On the oeHosts tab, press +, write 127.0.0.1 dev.example.com, and switch it on.

  4. Launch Chrome

    Press Launch Chrome on the right and open https://dev.example.com.

  5. Watch the traffic

    Open the Network tab to see requests and responses.

The full guide is in the README on GitHub.