Remote Hosts Server

ENGLISH | 中文文档

Tiny (5MB), Muti-Arch (ARM, x86) ,Easy (One Command), Docker Support (ARM, x86)

Manage and share your Hosts configuration, suitable for tools such as SwitchHosts.

Quick Start

Download the binaries from GitHub Releases page, then quickly start a service for sharing Hosts with just one command:

./remote-hosts-server

If you are a Docker user, you can use the following command instead:

docker run --rm -it -v `pwd`/data:/data -p 8080:8080 soulteary/remote-hosts-server

After the program runs, the service will be started on port 8080 by default, the port can be adjusted by setting something like PORT=8090 ./remote-hosts-server.

Then open the browser and you will see the interface, Update the Hosts content to your liking, then save it.

The program will intelligently judge whether it needs to be reviewed according to the actual situation, so as to avoid wrong submission and affect the normal use.

If you always don't want the second confirmation interface, you can add parameters MODE=simple (docker -e "MODE=simple") at startup to avoid it.

When we save the HOSTS, we can get the shared Hosts configuration by visiting http://ip:port/api/hosts (eg: http://localhost:8080/api/hosts)

Fill this address into Switch Hosts, set the appropriate update frequency, click Update Data to verify whether the data can be obtained, and then click OK to automatically update the configuration.

Docker

• Docker Hub

If you are used to using Docker Compose, you can refer to the following configuration:

version: '2'
services:

  remote-hosts-server:
    image: soulteary/remote-hosts-server
    ports:
      - "8080:8080"
    environment:
      # same with ports
      - PORT=8080
      # mode: normal or simple
      - MODE=normal
    volumes:
      - ./data:/data

Resources

• Gin-Gonic/Gin
• CodeMirror/CodeMirror5
• Google/Diff-Match-Patch
• CodeMirror Highlight rules for hosts
• Madrobby/Zepto
• Logo inspire by TajShireen
• Button inspire by coopergoeke