Repository navigation
Engine Camouflage
Outpace normally labels itself as Outpace. Peers, trackers, the search service and the catalog can see that. Engine camouflage is an opt-in profile in which those public values match one official Linux AceStream engine instead.
It is off by default and available from v1.1.0, as well as on current main and the edge image.
Restart the daemon after changing it. The local API, metrics, logs and the outpace: startup
lines stay Outpace's. One extra line confirms the profile:
outpace: AceStream identity enabled (linux 3.2.11)
export OUTPACE_ACESTREAM_IDENTITY=1
outpace serveoutpace play reads the same variables. Booleans accept 1, true, 0 or false.
Every other OUTPACE_ACESTREAM_IDENTITY_* variable is ignored while the switch is off.
A bad value stops startup before Outpace opens a listener, and the error names the variable.
Nothing is replaced with a guess.
Compose does not forward these variables. Put them in compose.override.yml; see
Deployment. The device id file lives in the data volume,
so keep that volume if you want the same id after a recreate.
With the profile on:
-
Search, when search is also enabled, uses the engine's parameter set
and order, including the device id and hardware key, and the fixed engine User-Agent.
Page 0 omits
h.sandtare not sent. - Catalog requests use the profile's version and platform in the signed query, a fresh Chrome User-Agent on each request, and the engine's header order.
- Peer handshakes use the profile's version and platform. After Outpace knows its public address, they also carry the ASN and country. Until then those keys are omitted.
-
UPnP mapping descriptions are
ASplus the first four hex digits of the device id, instead ofoutpace peer. See NAT and Port Mapping. -
Broadcast descriptors omit
outpace_name. The name remains in local state.
These stay the same either way:
- The node signing key and the peer id format.
- Tracker announces (
key=0, the real listen port). - Handshakes advertise the listen port you configured, and
tsis host uptime. See Seeding and Peers.
| Variable | Default | Accepted values |
|---|---|---|
OUTPACE_ACESTREAM_IDENTITY_VERSION |
3.2.11 |
X.Y.Z. The numeric code is X*1000000 + Y*10000 + Z*100 (3.2.11 is 3021100). |
OUTPACE_ACESTREAM_IDENTITY_PLATFORM |
linux |
linux only. |
OUTPACE_ACESTREAM_IDENTITY_DEVICE_ID |
random, then saved | 40 hex digits. |
OUTPACE_ACESTREAM_IDENTITY_HARDWARE_KEY |
from this host | 40 hex digits. |
OUTPACE_ACESTREAM_IDENTITY_ASN |
looked up | Integer, with or without an AS prefix. Not zero. |
OUTPACE_ACESTREAM_IDENTITY_COUNTRY |
looked up | Two letters. |
OUTPACE_ACESTREAM_IDENTITY_USER_AGENT |
the engine UA for the version | Printable ASCII, at most 256 characters. |
The device id is created the first time camouflage starts and stored as
acestream-device-id in OUTPACE_DATA_DIR (mode 0600 on Unix), next to the node identity.
It stays fixed across restarts. Setting OUTPACE_ACESTREAM_IDENTITY_DEVICE_ID uses that value
for the process and does not replace the saved id.
On Linux the hardware key is derived from the memory size reported in /proc/meminfo, which
is what the engine sends when its disk probe matches nothing. Hosts without that file, including
Windows, must set OUTPACE_ACESTREAM_IDENTITY_HARDWARE_KEY.
The handshake's ASN and country come from OUTPACE_ACESTREAM_IDENTITY_ASN and
OUTPACE_ACESTREAM_IDENTITY_COUNTRY when both are set. Setting only one is an error.
When neither is set, Outpace waits until two peers report the same public address, then makes
one HTTPS lookup to RIPEstat (stat.ripe.net) for the ASN and country. Redirects are not
followed. The fields stay omitted until that lookup succeeds. A failure is logged once as
[identity] network location lookup failed and is not fatal. Success is
[identity] recorded network location.
- It does not change what you see locally: routes, the startup banner, or logs.
- It does not emulate the engine's background calls to AceStream's own servers.
- It does not add Windows or Android profiles. Only the captured Linux profile is accepted.
- It does not play premium or encrypted content.
Full setting table: Configuration.
This wiki is generated from docs/wiki/ in the main repository. To fix or improve a page, open a pull request there; the wiki is republished automatically when it merges, and edits made in the wiki web UI are overwritten.
Start
Watching
Publishing and peers
- Broadcasting
- Seeding and Peers
- Engine Camouflage
- NAT and Port Mapping
- Private Peer Mode
- Outbound Proxy
Running it
- Deployment
- Routers and Small Devices
- Migrating from AceStream Engine
- Support Sources and Operations
- Troubleshooting
- Releases and Versions
Success stories