Public
Likeaccount-manager
Val Town is a collaborative website to build and scale JavaScript apps.
Deploy APIs, crons, & store data – all from the browser, and deployed in milliseconds.
Public
Likeks_live_xxx...)\n5. ⚠️ Lưu key này ở nơi an toàn\n\n### 1.3 Kiểm Tra Quyền\n\nĐảm bảo API key có quyền:\n- ✅ Create profiles\n- ✅ Delete profiles \n- ✅ Create proxies\n- ✅ Delete proxies\n- ✅ View live streams\n\n## 🌐 Bước 2: Triển Khai Val Town\n\n### 2.1 Truy Cập Val\n\n1. Link val: https://www.val.town/x/buonhayvui1404/account-manager/\n2. Bạn sẽ thấy editor code\n\n### 2.2 Cấu Hình Environment Variables\n\nOption A: UI (Recommended)\n\n1. Click ⚙️ Settings (góc trên phải)\n2. Cuộn xuống → Environment Variables\n3. Click + Add Variable\n4. Điền:\n - Key: KERNEL_API_KEY\n - Value: Paste API key từ Kernel\n5. Click Save\n\nOption B: CLI (Nếu dùng val CLI)\n\nbash\n# Cài val CLI (nếu chưa có)\nnpm install -g @valtown/cli\n\n# Login\nval auth\n\n# Set env var\nval env set KERNEL_API_KEY \"your_api_key_here\"\n\n\n### 2.3 Xác Nhận Deployment\n\n1. Val tự động deploy\n2. Kiểm tra status: xanh = online\n3. Truy cập endpoint:\n \n https://buonhayvui1404--3d51e8061f8911f18fb142dde27851f2.web.val.run\n \n (hoặc link được cung cấp)\n\n## 🧪 Bước 3: Test Ứng Dụng\n\n### 3.1 Test UI\n\n1. Mở link endpoint trong browser\n2. Bạn sẽ thấy giao diện Account Manager\n3. Kiểm tra:\n - ✅ Header hiển thị đúng\n - ✅ Form tạo proxy visible\n - ✅ Form tạo profile visible\n - ✅ Phần danh sách trống (first time)\n\n### 3.2 Test Tạo Proxy\n\n1. Điền form "Create Proxy":\n - Name: "Test Proxy"\n - Host: "8.8.8.8" (public DNS, test only)\n - Port: "80"\n2. Click "Create Proxy"\n3. Kết quả:\n - ✅ Alert "Proxy created successfully!"\n - ✅ Proxy hiện lên trong danh sách\n - ✅ Proxy ID được generate\n\n### 3.3 Test Tạo Profile\n\n1. Điền form "Create Profile":\n - Name: "Test Account"\n - Proxy: "Test Proxy" (từ bước trên)\n2. Click "Create Profile"\n3. Kết quả:\n - ✅ Alert "Profile created successfully!"\n - ✅ Profile hiện lên trong danh sách\n - ✅ Profile ID được generate\n - ✅ Kernel ID được lấy từ API\n\n### 3.4 Test Live View\n\n1. Tìm profile "Test Account"\n2. Click "👁️ Live View"\n3. Kết quả:\n - ✅ Cửa sổ mới mở (hoặc popup)\n - ✅ Hiển thị browser instance\n - ✅ Có thể thấy desktop/browser\n\n## 📊 Bước 4: Kiểm Tra Database\n\n### 4.1 Xem Data\n\nData được lưu trong SQLite local. Bạn có thể:\n\n1. Xem qua UI (dễ nhất):\n - Giao diện hiển thị tất cả profiles/proxies\n\n2. Xem qua SQL:\n sql\n SELECT * FROM profiles;\n SELECT * FROM proxies;\n \n\n### 4.2 Backup Data\n\nNếu cần backup:\n\n1. Export profiles list\n2. Export proxies list \n3. Lưu CSV hoặc JSON\n\n## 🔒 Bước 5: Bảo Mật\n\n### 5.1 API Key\n\n- ✅ Lưu trong environment variables\n- ✅ Không commit vào git\n- ✅ Rotate key hàng tháng\n- ✅ Có thể revoke nếu bị leak\n\n### 5.2 Proxy Credentials\n\n- ✅ Password được encrypt trong database\n- ✅ Không hiện password trong response API\n- ✅ Chỉ lưu username trong logs\n\n### 5.3 Val Privacy\n\n- ✅ Val được set thành Private\n- ✅ Chỉ bạn có thể truy cập\n- ✅ Database lưu local, không share\n\n## 📈 Bước 6: Scale Up\n\n### Khi cần tăng số account\n\n1. Tạo thêm proxy (khác nhau):\n \n Proxy 1 → Account 1\n Proxy 2 → Account 2\n Proxy 3 → Account 3\n ...\n \n\n2. Tạo profile tương ứng:\n - Mỗi account = 1 profile\n - Gán proxy khác nhau\n - Tránh bị chặn\n\n3. Monitor qua live view:\n - Click view lần lượt\n - Kiểm tra tình trạng\n\n### Performance\n\n- Val Town: Serverless, unlimited\n- SQLite: Hỗ trợ hàng triệu records\n- Kernel API: Theo giá dịch vụ của họ\n\n## 🐛 Troubleshooting Deployment\n\n### ❌ "500 - Internal Server Error"\n\nNguyên nhân 1: API Key sai\nbash\n# Check\n1. Kiểm tra API key trong Settings\n2. Xác nhận key không hết hạn\n3. Copy lại từ Kernel dashboard\n\n\nNguyên nhân 2: Kernel API down\nbash\n1. Kiểm tra status: https://status.kernel.sh\n2. Chờ vài phút\n3. Try again\n\n\n### ❌ "Cannot read properties of undefined"\n\nNguyên nhân: Database không initialize\nbash\n1. Val cần tải lần đầu\n2. Refresh page\n3. Chờ 10 giây\n\n\n### ❌ "CORS Error"\n\nNguyên nhân: Cross-origin request\nbash\n# Not issue, should work từ val.town domain\n1. Refresh\n2. Check console (F12)\n\n\n### ❌ "Live View not working"\n\nNguyên nhân 1: Profile quá cũ\nbash\n1. URL live view hết hạn\n2. Tạo profile mới\n\n\nNguyên nhân 2: Browser popup blocked\nbash\n1. Check popup blocker settings\n2. Allow popups cho val.town\n\n\n## 📚 File Structure\n\n\naccount-manager/\n├── main.ts # HTTP handler + UI\n├── api-config.ts # Kernel API helpers\n├── README.md # Dokumentasi lengkap\n├── QUICK-START.md # Panduan cepat\n├── API-REFERENCE.md # Reference API\n└── DEPLOYMENT-GUIDE.md # File ini\n\n\n## 🔄 Updates & Maintenance\n\n### Monitoring\n\n1. Daily:\n - Check live view of accounts\n - Monitor proxy status\n\n2. Weekly:\n - Review logs\n - Update if issues found\n\n3. Monthly:\n - Rotate API keys\n - Backup data\n - Review Kernel pricing\n\n### Updating Code\n\nJika cần update:\n\n1. Edit file trong Val Town editor\n2. Auto-saves\n3. Auto-deploys\n4. No downtime needed\n\n## 📞 Support & Help\n\n### Kernel Issues\n\n- Docs: https://kernel.sh/docs/api-reference/\n- Status: https://status.kernel.sh\n- Support: support@kernel.sh\n\n### Val Town Issues\n\n- Docs: https://docs.val.town\n- Discord: https://discord.gg/dHptV3J3F4\n\n### Account Manager Issues\n\n- Check QUICK-START.md\n- Review README.md\n- Check API-REFERENCE.md\n\n## ✅ Deployment Checklist\n\n\n[ ] Kernel API Key ready\n[ ] Set KERNEL_API_KEY env var\n[ ] Val deployed successfully\n[ ] UI loading correctly\n[ ] Test proxy creation\n[ ] Test profile creation\n[ ] Test live view\n[ ] Verify database\n[ ] Check API endpoints\n[ ] Security settings reviewed\n[ ] Ready for production\n\n\n## 🎉 Success!\n\nNếu bạn thấy:\n- ✅ UI load đúng\n- ✅ Tạo proxy được\n- ✅ Tạo profile được\n- ✅ Live view mở được\n\n→ Congratulations! Account Manager đã sẵn sàng 🚀\n\n---\n\nNeed help? Kiểm tra troubleshooting section hoặc contact support!\n"