docs: hosts

hosts/README.md

@@ -5,18 +5,18 @@
    1. `harmonica`: MacBook Pro 2020 13-inch i5 16G, for personal use.
 2. `idols`
    1. `ai`: My main computer, with NixOS + I5-13600KF + RTX 4090 GPU, for gaming & daily use.
-   2. `aquamarine`: My NixOS virtual machine as a passby router(IPv4 only) to access the global internet.
-   4. `ruby`: Another NixOS vm with R9-5900HX(8C16T), for distributed building & testing.
-   3. `kana`: Yet another NixOS vm, for various services.
-3. `rolling_girls`: My RISCV64 hosts.
+   2. `aquamarine`: My NixOS virtual machine as a router(IPv4 only) with a tranparent proxy to bypass the G|F|W.
+   4. `ruby`: Another NixOS VM running operation and maintenance related services, such as prometheus, grafana, restic, etc.
+   3. `kana`: Yet another NixOS VM running some common applications, such as hompage, file browser, torrent downloader, etc.
+3. Homelab:
+   1. `tailscale_gw`: A tailscale subnet router(gateway) for accessing my homelab remotely. NixOS VM running on Proxmox.
+4. `rolling_girls`: My RISCV64 hosts.
    1. `nozomi`: Lichee Pi 4A, TH1520(4xC910@2.0G), 8GB RAM + 32G eMMC + 64G SD Card.
    2. `yukina`: Lichee Pi 4A(Internal Test Version), TH1520(4xC910@2.0G), 8GB RAM + 8G eMMC + 128G SD Card.
    3. `chiaya`: Milk-V Mars, JH7110(4xU74@1.5 GHz), 4G RAM + No eMMC + 64G SD Card.
-4. `12kingdoms`: 
+5. `12kingdoms`: 
    1. `shoukei`: NixOS on Macbook Pro 2022 Intel i5, 13.3-inch, 16G RAM + 512G SSD.
    1. `suzu`: Orange Pi 5, RK3588s(4xA76 + 4xA55), GPU(4Cores, Mail-G610), NPU(6Tops@int8), 8G RAM + 256G SSD.
-5. Homelab:
-   1. `tailscale_gw`: A tailscale subnet router(gateway) for accessing my homelab remotely. NixOS VM running on Proxmox.
 6. Kubernetes Cluster(TODO):
    1. For production:
       1. `k8s-prod-master-1`
@@ -31,10 +31,20 @@
       3. `k8s-test-worker-2`
       4. `k8s-test-worker-3`
 
-# idols - Oshi no Ko
+## idols - Oshi no Ko
 
-These four servers are named after the four main characters of the mange/anime Oshi no Ko, they form a NixOS distributed building cluster,
-I usually run the build command on `Ai` and nix will distribute the build to other three machines, which is convenient and fast.
+These four servers are named after the four main characters of the mange/anime Oshi no Ko.
+
+## rolling girls
+
+My All RISCV64 hosts.
+
+![](/_img/nixos-riscv-cluster.webp)
+
+
+## Distributed Building
+
+I usually run the build command on `Ai` and nix will distribute the build to other NixOS machines, which is convenient and fast.
 
 When building some packages for riscv64 or aarch64, I often have no cache available because of various changes under the hood, so I need to build much more packages than usual, which is one of the reasons why the cluster was originally built, and another reason is distributed building is cool!
 
@@ -42,11 +52,6 @@ When building some packages for riscv64 or aarch64, I often have no cache availa
 
 ![](/_img/nix-distributed-building-log.webp)
 
-## rolling girls
-
-My All RISCV64 hosts.
-
-![](/_img/nixos-riscv-cluster.webp)
 
 ## References
 

hosts/idols_aquamarine/README.md

@@ -1,6 +1,6 @@
 # Idols - Aquamarine
 
-Use aqua as a passby router(IPv4 only) to access the global internet.
+A router(IPv4 only) with a tranparent proxy to bypass the G|F|W.
 
 NOTE: dae(running on aquamarine) do not provides http/socks5 proxy server, so a v2ray server is running on [homelab_tailscale_gw](../homelab_tailscale_gw/proxy.nix) to provide the http/socks5 proxy service.
 

hosts/idols_kana/README.md

@@ -1,7 +1,9 @@
 # Idols - Kana
 
-Use kana for common applications.
-All the services assumes a reverse proxy to be setup in the front, they are not exposed to the internet directly.
+Host running some common applications, such as hompage, file browser, torrent downloader, etc.
+
+All the services assumes a reverse proxy to be setup in the front, they are all listening on localhost,
+and a caddy service is listening on the local network interface and proxy the requests to the services.
 
 ## Services
 

hosts/idols_ruby/README.md

@@ -1,9 +1,14 @@
 # Idols - Ruby
 
-TODO: use ruby for backup / sync my personal data, and monitor the status/logs of my homelab.
-For safety, those data should be encrypted before sending to the cloud or my NAS.
+Host running operation and maintenance related services:
 
-1. prometheus: Monitor the status of my homelab
-1. restic: Backup file from homelab to NAS, or from NAS to Cloud
-1. synthing: Sync file between android/macbook/PC and NAS
+1. Backup or sync my personal data to cloud or NAS.
+   - For safety, those data should be encrypted before sending to the cloud or my NAS.
+1. Collect and monitor the metrics/logs of my homelab.
+
+## Services
+
+1. prometheus + alertmanager + grafana + loki: Monitor the metrics/logs of my homelab.
+1. restic: Backup my personal data to cloud or NAS.
+1. synthing: Sync file between android/macbook/PC and NAS.