Remote Access to Your Voice Service

What You Need Before Starting

This page is part of the advanced integration documentation. The default premise is that you clearly understand this is a user-managed local voice service, not a NovelPlayer-hosted online capability.

If you just want to try the product first, it is recommended to stay with the built-in lightweight TTS or local access on the same LAN. Only continue reading this page when you genuinely need to access your own device across networks.

Before reading this page, assume you already have the following prerequisites:

1. You have registered a Cloudflare account
2. Your Cloudflare account already has a domain
3. If you do not have a domain yet, you can purchase one yourself, for example via Cloudflare Registrar: https://www.cloudflare.com/products/registrar/
4. You have enabled the Cloudflare Zero Trust free plan
5. Your local voice service is already running normally on a local computer or server

If the local voice service is not running yet, it is recommended to go back and read "Prerequisites & Preparation" and "Local Access" first.

The Most Direct Remote Access Flow

If you just want NovelPlayer to connect to your local voice service from the internet, the simplest flow is:

1. Create a Tunnel in Cloudflare Zero Trust
2. Install and run the cloudflared connector
3. Bind a domain of yours to this Tunnel, for example a.yourdomain.com
4. Forward this domain to your local voice service, for example http://192.168.1.1:50001
5. Fill this public address back into the NovelPlayer endpoint

This route corresponds by default to "Option A: Tunnel only, no Access" below.

Create a Tunnel in Cloudflare

After enabling Zero Trust, open the Cloudflare Zero Trust dashboard:

1. Click "Networks"
2. Click "Connectors"
3. Create a new Tunnel
4. Give the Tunnel a name you can recognize

After creation, Cloudflare will move to the "Install and run a connector" step.

Install and Run the Connector

The Cloudflare page will prompt you to install the connector on the machine actually running the voice service.

Using Windows 64-bit as an example, the flow can be written as:

1. Download the cloudflared installer: https://github.com/cloudflare/cloudflared/releases/latest/download/cloudflared-windows-amd64.msi
2. Run the installer
3. Open a command prompt as administrator
4. Run the install command shown on the Cloudflare page, for example:

cloudflared.exe service install eyJhIjoiMz...

Keep this token safe. Whoever has this token can potentially connect a connector to your Tunnel.

The Cloudflare page generates the matching command based on your operating system and architecture; if you are not on Windows 64-bit, just run the command shown on the page.

Configure the Public Domain and Local Service for the Tunnel

After the connector is installed, the next step is to add a public hostname to the Tunnel.

A common configuration is:

• Public hostname: a.yourdomain.com
• Service type: HTTP
• Service URL: http://192.168.1.1:50001

What this means:

• External users visit a.yourdomain.com
• Cloudflare Tunnel then forwards the request to your local voice service on your LAN
• 192.168.1.1:50001 is just an example; you should change it to the actual IP and port of your voice service machine

If your local voice service runs on the same machine where cloudflared is installed, you can also configure the service URL like:

http://127.0.0.1:50001

How to Fill in the Endpoint in NovelPlayer

Once the Tunnel and the public domain are configured, go back to the NovelPlayer Manager screen.

It is recommended to fill in the complete address:

https://a.yourdomain.com/