Vận hành node quyền riêng tư phi tập trung

“Vận hành và kiểm tra sức khỏe node quyền riêng tư phi tập trung” là trang bản địa hóa chính thức trong tài liệu AeroNyx. AeroNyx tách lớp giao thức khỏi trải nghiệm sản phẩm: giao thức cung cấp năng lực mở và bền vững, còn App, Nodeboard, chat mã hóa, lưu trữ mã hóa và vận hành node tạo nên trải nghiệm sử dụng.

Tổng quan

Trang này giải thích bằng tiếng Việt vai trò của “Vận hành và kiểm tra sức khỏe node quyền riêng tư phi tập trung” trong giao thức quyền riêng tư mở AeroNyx, phạm vi hiện tại, các bất biến quyền riêng tư và lưu ý phát triển/vận hành.

Vị trí trong kiến trúc AeroNyx

Chủ đề này thuộc Nhà vận hành node. AeroNyx nên được hiểu là một tập năng lực giao thức được dùng chung bởi client, node quyền riêng tư phi tập trung, bộ điều phối backend và Nodeboard, không phải một dịch vụ tập trung duy nhất.

Trọng tâm triển khai hiện tại

Mọi năng lực liên quan tới nội dung người dùng phải đi qua mã hóa đầu cuối hoặc đối tượng mã hóa.
Node quyền riêng tư phi tập trung có thể báo cáo sức khỏe, dung lượng, kết nối, bằng chứng đường đi và thống kê tổng hợp, nhưng không đọc tin nhắn, thông tin truy cập hay bí mật người dùng.
Nodeboard cung cấp khả năng quan sát vận hành: sức khỏe node, peer discovery, phục hồi sau restart, dung lượng, gói/lưu lượng và trạng thái giao thức.
Ở giai đoạn hiện tại backend điều phối, sắp xếp, tổng hợp và cung cấp API tài liệu công khai; một số trách nhiệm có thể chuyển dần xuống lớp Rust.

Ranh giới quyền riêng tư

Bất biến cốt lõi của AeroNyx là blind-node invariant: node relay và bộ điều phối MemChain chỉ xử lý ciphertext, timestamp, proof, tín hiệu sức khỏe tổng hợp và metadata định tuyến giới hạn. Chúng không được đọc plaintext, DNS, đích truy cập hoặc tái dựng quan hệ giao tiếp.

Điều nhà vận hành node cần theo dõi

Nhà vận hành cần theo dõi băng thông, giới hạn kết nối, IP pool, conntrack, file descriptor, packet drops, pps, bps, peer store, độ mới heartbeat và restart recovery. Giao diện nên hỗ trợ chẩn đoán nhưng không lộ nội dung người dùng hoặc dữ liệu có thể liên kết danh tính.

Tích hợp cho nhà phát triển và sản phẩm

Client, App, AI agents và dịch vụ bên thứ ba nên tái sử dụng envelope mã hóa, chữ ký, blind relay, thông tin xác thực ẩn danh và healthcheck của AeroNyx. API mới phải tách rõ metadata công khai và trường phải nằm trong E2E payload.

Trạng thái hiện tại

Trang này mô tả ranh giới công khai hiện tại của giao thức và sản phẩm AeroNyx. multi-hop routing, blind-signed vouchers, encrypted media blob, đồng bộ MemChain và nâng cấp node discovery cần được duy trì dưới cùng translation_key.

Vận hành witness được ghim

Witness được ghim là chính sách tin cậy rõ ràng của operator dành cho MemChain commitment coordinator. Chỉ cấu hình follower vận hành độc lập, đã được kiểm toán và có nhiệm vụ giữ lịch sử của coordinator này.

toml

[memchain]
commitment_coordinator_enabled = true
commitment_witness_node_ids = ["<64-hex-ed25519-node-id-1>", "<64-hex-ed25519-node-id-2>"]
commitment_witness_startup_required = false
commitment_witness_min_verified = 2

Thay mọi placeholder trước khi validate. Chỉ chấp nhận tối đa ba ID Ed25519 32-byte duy nhất, khác 0; cấu hình chỉ hợp lệ trên coordinator.

Rollout an toàn: nâng cấp ít nhất hai follower được kiểm toán; thêm đúng ID khi strict tắt; chạy aeronyx-server validate -c /etc/aeronyx/server.toml; restart và xác nhận bằng chứng có chữ ký trong phạm vi operator_pinned; chỉ bật strict sau khi lặp lại kiểm tra.

Khi strict tắt, witness không truy cập được tạo cảnh báo degraded rõ ràng nhưng vẫn giữ khả dụng. Remote-ahead hoặc divergence có chữ ký luôn chặn khởi động. Khi strict bật, không có bằng chứng đã xác minh cũng chặn khởi động.

Checkpoint là endpoint giao thức có chữ ký; GET ẩn danh không phải health check. Witness tăng khả năng phát hiện rollback nhưng tự nó không tạo consensus, quorum hay finality.

Triển khai production đã xác minh — 14/7/2026

Một coordinator production có ba danh tính witness do operator ghim rõ ràng. Hai follower được vận hành độc lập và kiểm toán hiện cung cấp checkpoint tương thích; mỗi node đã xác minh và lưu cùng một lịch sử gồm 33 block và 8.339 commitment. Coordinator chấp nhận hai phản hồi converged riêng biệt có chữ ký của hai follower, sau đó mới bật commitment_witness_startup_required = true.

Trong lần restart đã xác minh, startup guard báo configured=3, eligible=3, attempted=3, verified=2 và converged=2; listener UDP và TUN chỉ mở sau khi kiểm tra đạt yêu cầu. Đây là bằng chứng rollback từ node do operator ghim, không phải consensus, quorum, finality của public chain hay token execution.

Bắt buộc ngưỡng khởi động 2-of-3 — 14/7/2026

Coordinator production hiện đặt commitment_witness_min_verified = 2 cùng với commitment_witness_startup_required = true. Node từ chối khởi động nếu có ít hơn hai witness được ghim và khác nhau cung cấp bằng chứng chữ ký hợp lệ: không có phản hồi hợp lệ trả về signed_checkpoint_unavailable, còn chỉ một phản hồi trả về signed_checkpoint_threshold_unmet. Lần restart production gần nhất đã xác minh hai trong ba witness trước khi mở UDP, TUN hoặc public API listener.

Đây là ngưỡng khởi động do operator định nghĩa, không phải consensus mạng, quorum, finality, bầu leader hay fork choice. Rust heartbeat chỉ báo các trường chính sách và kết quả tổng hợp, gồm startup_minimum_verified, không lộ danh tính witness, endpoint, checkpoint hash hoặc chữ ký.

Đặc tả giao thức liên quan

Sổ cam kết có chữ ký và bảo vệ bằng witness

Kiểm tra toàn vẹn MemChain AOF

Thêm cổng chỉ đọc này vào mọi upgrade và restart có kế hoạch. Output tổng hợp an toàn cho tự động hóa vận hành.

bash

sudo aeronyx-server memchain verify-aof \
  --config /etc/aeronyx/server.toml

sudo aeronyx-server memchain verify-aof \
  --path /var/lib/aeronyx/.memchain

Kết quả	Hành động vận hành
`status: verified` và `torn_tail_bytes: 0`	Tiếp tục validate cấu hình và guarded restart.
`torn_tail_detected`	Không sửa tệp thủ công. Chỉ guarded append-open mới được bỏ physical tail chưa hoàn chỉnh sau semantic scan đầy đủ.
Lỗi toàn vẹn	Dừng lại. Giữ AOF và log cho incident review; hỏng semantic của record hoàn chỉnh phải fail closed.

Quyền riêng tư: Không upload, paste hoặc công khai chính tệp AOF. Chỉ chia sẻ output tổng hợp của verifier.

Ranh giới toàn vẹn và bằng chứng đầy đủ: Sổ cam kết có chữ ký và bảo vệ bằng witness.

Bảo trì Cargo build cache có kiểm soát

Các lần build mã nguồn lặp lại có thể để lại hàng chục GB đối tượng Cargo có thể tái tạo. Lệnh vận hành thống nhất kiểm tra và thu hồi dung lượng mà không xóa trạng thái giao thức hay restart service.

1. Kiểm kê không thay đổi host

Trước tiên chạy inventory chỉ đọc. Nó hiển thị target cũ, build root cô lập, phiên bản Rust được ghim, SHA-256 của binary được bảo vệ và dung lượng filesystem tổng hợp.

bash

cd /root/open/AeroNyx
./deploy/node/aeronyx-node.sh build-cache --repo-dir "$PWD"

2. Xem trước từng mục có thể xóa

Kiểm tra dry-run từng dòng. Xóa yêu cầu root và --yes rõ ràng; status và upgrade không tự động dọn dẹp.

bash

sudo ./deploy/node/aeronyx-node.sh prune-build-cache \
  --repo-dir "$PWD" \
  --dry-run

3. Chạy dọn dẹp đã xác nhận

bash

sudo ./deploy/node/aeronyx-node.sh prune-build-cache \
  --repo-dir "$PWD" \
  --yes

Nếu dùng build root tùy chỉnh, hãy export AERONYX_BUILD_TARGET_ROOT cho cả ba lệnh để inventory và prune dùng cùng target cô lập.

Phạm vi được bảo vệ và có thể xóa

Được bảo vệ: Giữ target/release/aeronyx-server, cache toolchain/service hiện tại, executable release và rollback artifacts khác, dữ liệu giao thức /var/lib/aeronyx, identity/config /etc/aeronyx và cache của service khác.
Có thể tái tạo: Chỉ xóa output Cargo có thể tái tạo: thư mục debug/cross-target cũ, deps, build, .fingerprint, incremental, .rlib, .rmeta, .d và target toolchain cũ của cùng service.
Bảo vệ thực thi: Trước khi xóa, lệnh lấy deployment lock chung với install/upgrade và xác minh MainPID đang chạy binary được bảo vệ. Hash được tính trước và sau; thay đổi sẽ làm thao tác thất bại.

Xác minh sau bảo trì

Dọn cache không restart node và không cần drain active session. Sau đó xác nhận service health, startup readiness, discovery quorum và độ mới của bằng chứng hai hop.

bash

./deploy/node/aeronyx-node.sh status --repo-dir "$PWD"
./deploy/node/aeronyx-node.sh health --repo-dir "$PWD" --json

Bằng chứng xác minh production — 26 tháng 7 năm 2026

Một lần chạy có kiểm soát thu hồi 50,649,768 KiB; mức dùng giảm từ 90% xuống 65%. SHA-256, MainPID và số restart không đổi; startup không lỗi và bằng chứng hai hop vẫn ready/stable.

Ranh giới quyền riêng tư: Inventory chỉ hiển thị path cục bộ, kích thước, phiên bản toolchain, binary hash và dung lượng tổng hợp. Nó không đọc payload mã hóa, record MemChain, khóa, peer identity, route, địa chỉ client, DNS, đích hoặc social graph.

Vận hành cognitive worker tùy chọn

SuperNode cognitive worker là tùy chọn và mặc định tắt. Chỉ bật trên node xử lý có vai trò tin cậy đã được hiểu rõ.

Cấu hình tối thiểu cho nhà cung cấp cục bộ

toml

[memchain.supernode]
enabled = true

[[memchain.supernode.providers]]
name = "local-ollama"
type = "openai_compatible"
api_base = "http://127.0.0.1:11434/v1"
api_key = ""
model = "llama3.2"
max_tokens = 1000
temperature = 0.3

[memchain.supernode.routing]
fallback = "local-ollama"

[memchain.supernode.privacy]
default_level = "structured"
allow_full_for = []

Cũng hỗ trợ api_key = "$ENV_VAR". Không đưa bí mật vào cấu hình đã commit.

Dạng endpoint tương thích OpenAI

Cả ba dạng đều trỏ đến cùng endpoint Chat Completions:

https://provider.example
https://provider.example/v1
https://provider.example/v1/chat/completions

Với type = "anthropic", có thể bỏ api_base; runtime hiện tại dùng endpoint Anthropic Messages chính thức.

Hành vi lỗi và giới hạn tài nguyên

Phản hồi thành công bị giới hạn 8 MiB trước khi phân tích JSON; nội dung chẩn đoán lỗi bị giới hạn 64 KiB.
Lỗi truyền tải, API, phân tích hoặc phản hồi rỗng đưa nhà cung cấp vào cooldown 30 giây theo đồng hồ đơn điệu thay vì vô hiệu hóa vĩnh viễn.
HTTP 429 Retry-After được áp dụng trong 1-300 giây; nếu thiếu thì dùng 30 giây.
Router có thể dùng nhà cung cấp khỏe khác và tự xét lại nhà cung cấp lỗi sau cooldown. Không cần tác vụ định kỳ.

Trước khi khởi động lại, chạy aeronyx-server validate -c /etc/aeronyx/server.toml. Hành vi này có trong main hiện tại; node đã cài cần được build lại hoặc nâng cấp lên bản phát hành có thay đổi này.

Ranh giới riêng tư: node lưu trữ và relay vẫn node-blind. Cognitive worker đã bật và nhà cung cấp bên ngoài thấy prompt được mức riêng tư cho phép. Giữ default_level = "structured"; để trống allow_full_for nếu chưa có đồng ý rõ ràng cho nội dung đầy đủ.