finalized

README.md

@@ -1,3 +1,85 @@
-# emby-proxy-helper
+# Emby Proxy Helper
 
-Educational Docker-based media server lab using Emby Server and reverse proxy. Repository contains only references; software runs on a self-hosted server.
+## ⚠️ Legal and Ethical Notice (For Educational Purposes Only)
+This project is intended solely for educational, research, development, and testing purposes on networks under your control.
+Using this software to bypass licensing mechanisms, use paid features without authorization, or violate terms of service is not recommended, and the responsibility lies entirely with the user.
+
+## 🚀 Overview
+Two Docker-based services: Emby Server + Nginx helper
+Host scripts: Windows, Linux, macOS (shell/ folder)
+Services can access the same files via shared volumes and networks
+
+## ⚡ Startup
+
+Run the `start.cmd` file according to your operating system.
+
+### Windows
+
+```cmd
+> .\start.cmd
+```
+### Linux/Mac
+
+```bash
+$ sudo sh start.cmd
+```
+
+## 🛠 Configuration
+
+Do not modify the mount and interface structure in `docker-compose.yml`.
+
+Add your media paths under `x-common-volumes`.
+
+
+## 🌐 To access Global Premiere Features (Global Reverse Proxy)
+
+A proxy server is required for this process. (e.g., Raspberry Pi)
+- Install AdGuard Home
+- Assign a static IP to the Pi
+- Assign a subdomain to your domain address on Cloudflare: `dns.example.com`
+
+    | Type | Name | Proxy | TTL  |
+    |------|------|-------|------|
+    | A    | dns  | DNS only - reserved IP | Auto |
+
+
+- Obtain a Let’s Encrypt SSL certificate for `dns.example.com` using Certbot
+- Restart **AdGuardHome.service**
+- Go to dns.example.com → Setup tab → Configure DoH / DoT settings for your modem network
+
+**Add a global host:**
+```bash
+35.209.229.156 mb3admin.com
+```
+
+## 📱 Client Apps
+
+Depending on your needs, you can use one of the following apps:
+
+- Android TV
+- Android
+- iOS
+- Apple TV
+
+Log in to the server and confirm the certificate warning to proceed.
+
+## Manual Certificate Installation (Optional)
+If you want to use Emby via a web browser, you will likely need to install the certificate manually. Under normal circumstances, `start.cmd` automatically handles this for your operating system. However, for devices like PlayStation and Xbox, you can also try installing the certificate manually using a Homebrew Enabler/Payloader. 
+
+Download the `*.crt` file from below and install it on the relevant device.
+
+```bash
+$ curl -O https://arg0.dev/emby/mb3admin.crt
+```
+
+Alternatively, if you cannot do this, you can bypass the HTTP error by simply visiting `mb3admin.com` in your browser before accessing the Emby web interface, and then proceed with the Emby web environment.
+
+That’s it.
+
+# Summary
+This project should be used to:
+Learn network configuration
+Test reverse proxy logic
+Examine Docker-based service architectures.
+
+In real-world use cases, you must always comply with the relevant software’s license and terms of use.