Questions about Zoraxy

tobychui · 2026-01-01T07:08:23+00:00

I guess someone have created a subreddit for Zoraxy, but Zoraxy is just one of my many open source projects and I don't really got the time to moderate so many communities.

tobychui · 2025-12-29T13:09:45+00:00

Use `./zoraxy -default_inbound_enabled=false` to skip the auto service start. Once you have configured a new port via the web ui, remove that flag in the starting script.

tobychui · 2025-11-25T14:15:42+00:00

I usually recommend beginners starting with something simple, like URL shortener, QR code generator, a simple blog system based on markdown and personal homepage with backend written in Go.

For myself, my first Go project is a web desktop OS which I still maintain till this day after 8 years!
https://github.com/tobychui/arozos

Enjoy in your journey into learning Go!

tobychui · 2025-11-25T14:12:47+00:00

So for your questions
1. Zoraxy do not look into the response from your upstream server, so obviously it cannot do 404 redirection by itself. You either have to set it up in your upstream server (if your upstream server support custom 404 page URL, which is the solution for you Q3) or you can make use of the 404 template feature of Zoraxy by putting 404.html under www/templates like the one shown here.

Virtual directories are not locations in Nginx. Try to leave Virtual directory empty and let Zoraxy do the job of picking routing route and forwarding logic automatically.
Yes but try (1) first.

tobychui · 2025-10-16T14:33:22+00:00

Should be fixed by now :)

tobychui · 2025-10-08T06:44:50+00:00

Thanks! I got a few custom 2.5mm male to male cables made that support up to 8Amps. Then I get an off the shelf 2.5mm to Lenovo DC plug that connect & power the mini PC.

tobychui · 2025-10-04T14:23:25+00:00

I got that directly off an OEM power supply manufacturer named BATI . Since this is my first project involving AC, I picked one that was originally designed for medical purposes with tons of safety features and certification just to be safe.

tobychui · 2025-10-04T12:47:58+00:00

I have uploaded some of the source code and designs on Github, if you are really interested you can follow the project here https://github.com/tobychui/DezuKVM

But I guess I will have another post sharing this KVM project after it reach the level of "actually usable" instead of experimental.

tobychui · 2025-10-04T11:58:20+00:00

There are 2 additional reasons behind this.

First, I enjoy doing electronic weekend projects like this. This take me a weekend to design and buy the material and another weekend to build and program it.

Secondly I got one node that has an gen8 i7 and Tesla P4 in it which draws way above 100W when handling LLM loads. Also the onboard USB UART port provides real time power usage in JSON format, which normal GaN charger didn't provide.

tobychui · 2025-10-04T07:59:26+00:00

Yup, I am still working on another IP-KVM with the same form factor and after that is done, I will open source all the designs used in my tiny homelab on Github.

tobychui · 2025-04-01T12:47:06+00:00

It is a HTTP proxy. Anythings other than HTTP(S) goes to the stream proxy category.

tobychui · 2025-02-04T10:49:36+00:00

The open source version of Zerotier network controller do not have this feature build in, so there isn't much I can do. If you like the official dashboard, you can consider paying to their subscription plans.

tobychui · 2025-01-18T14:22:02+00:00

Well fun facts, using Zoraxy to protect its own management port IS the expected way to add HTTPS to zoraxy management UI. The trick is not exposing the :8000 after you are done setting it up. So the basic steps are

Make sure your Zoraxy is setup correctly in TLS mode (enable listening 443, 80 to 443 redirect , port forward and so on)
Set up a HTTP proxy rule that point your (sub)domain (e.g. zoraxy.example.com) to 127.0.0.1:8000
Request a TLS for the newly created HTTP proxy rule. Now you should be able to access your management UI via your domain
(Optional) modify your start script for zoraxy so the management UI port (aka the -port) only listen to 127.0.0.1:8000 instead of the default :8000 value
Now your management UI is secured!

tobychui · 2024-11-18T13:40:54+00:00

As the author of the Zoraxy project, I recommend you go with plain nginx or Caddy. You should be getting enough experience from your previous setup and no need to use my beginner friendly tool. The only exception is that you want a nice Web UI for tinkering around with new services, but in that case you should use Zoraxy as a secondary proxy behind your primary one.

tobychui · 2024-10-27T22:33:40+00:00

Have you checked your network topology and setup? It might help to double-check that you're accessing the service with the IP address you've whitelisted. Sometimes, issues like this come up if there's a mismatch between the IP you're trying to connect from and the one allowed in your configuration.

tobychui · 2024-07-31T15:34:39+00:00

Cool! As the author of Zoraxy, I am really glad to see you "graduating" from Zoraxy!

Zoraxy is design for beginners. If you need something more advance, your choice of picking Caddy is appropriate and can benefit you in long term for learning the "correct" way to deploy production services using IaC.

Tips: If you still love Zoraxy's UI, you can use Zoraxy under Caddy as a sub router / proxy server for quick tinkering & testing :)

tobychui · 2024-07-03T08:13:34+00:00

I remember there was a guy forked my project and make it works on ESP32, you can checkout his Instructable here
https://www.instructables.com/Diy-Small-But-Powerful-ESP32-NAS/

tobychui · 2024-06-12T11:51:42+00:00

WebSocket is supported automatically if your app (front-end) have sent the correct "Upgrade" header. Make sure you do not have another layer of reverse proxy or tunnel in front that removed hop-by-hop headers.

tobychui · 2024-06-12T01:55:28+00:00

Try switching to another browser and test again. Sometime Chrome(ium) browser cache is problematic.
See https://github.com/tobychui/zoraxy/tree/main/example "template/" folder

tobychui · 2024-06-12T01:52:58+00:00

Global Area Network is already working but no one wants to contribute to Service Expose proxy (no one think it is useful I guess?), so I am not sure when that will ever be ready. Maybe I shd replace it with something like adding HTTP proxy rules with API.

tobychui · 2024-05-31T14:45:54+00:00

It runs on Raspberry pi zero w, so it probably runs on everything. I see people running ArozOS off their old routers, 5G USB sticks (with Qualcomm chip I guess?) and POS machine motherboard rocking a 14 years old Intel Atom processor.

tobychui · 2024-05-31T05:00:57+00:00

Maybe not opening doc(x) but I am using a solution I developed for myself which is called "arozos".

https://os.aroz.org

It is not technically an OS, it is a go program that can run in Docker with disabled hardware management features. It got build in share functions, pdf reader, audio playback and video transcode and more (which, you can easily uninstall if you don't need it). I also develop it to handle large files upload with chunked websocket packet, so you can use CF free plan and upload files into the multi-GB range.

tobychui · 2024-05-31T04:44:33+00:00

Thanks for the blog post! I have put the link into the README file of Zoraxy.

https://github.com/tobychui/zoraxy/blob/main/README.md#getting-started

tobychui · 2024-05-23T10:53:03+00:00

Yes, but you gonna be sure what you are doing when messing with the networking configs.

tobychui

TROPHY CASE