# GETID FACEBOOK - TOOL_FACEBOOK API + Web UI lấy UID Facebook từ: * Profile URL * Share URL * profile.php?id=... * Username / Vanity URL Viết bằng Go, frontend được nhúng bằng go:embed, không cần NodeJS hay npm. --- ## TÍNH NĂNG ✓ Lấy UID Facebook từ link profile ✓ Hỗ trợ link share Facebook ✓ Hỗ trợ profile.php?id= ✓ Hỗ trợ username/slug ✓ API REST JSON ✓ Web UI tích hợp sẵn ✓ Hỗ trợ Proxy outbound ✓ Chạy độc lập (single binary) ✓ Linux / Windows ✓ Không cần NodeJS --- ## YÊU CẦU HỆ THỐNG Go : >= 1.21 Git : Tùy chọn .env : Đặt cạnh binary NodeJS : Không cần Tải Go: https://go.dev/dl/ --- ## CẤU TRÚC THƯ MỤC tool_facebook/ ├── main.go ├── static.go ├── static/ │ └── index.html ├── go.mod ├── .env ├── README.md └── tool_facebook.exe Mô tả: main.go : API + xử lý Facebook static.go : Embed frontend static/index.html : Giao diện web .env : Cấu hình runtime README.md : Tài liệu tool_facebook : Binary sau build --- ## SETUP NHANH 1. Clone project git clone cd tool_facebook Hoặc copy source trực tiếp. --- 2. Tạo file .env FB_COOKIE=datr=...; sb=...; LISTEN=:8787 PROXY_HOST= PROXY_USER= PROXY_POOL= USE_PROXY=false PROXY_FALLBACK_DIRECT=true TIMEOUT=12 RETRIES=0 Lưu ý: Không commit cookie Facebook thật lên GitHub. --- 3. Build Windows: go build -o tool_facebook.exe . Linux: go build -o tool_facebook . chmod +x tool_facebook --- 4. Chạy Windows: .\tool_facebook.exe Linux: ./tool_facebook Kết quả mong đợi: > > Đã load .env > > Proxy RA NGOÀI: TẮT > > Server đang lắng nghe tại :8787 --- 5. Truy cập Website: http://127.0.0.1:8787 API: http://127.0.0.1:8787/api/v1/facebook Health Check: http://127.0.0.1:8787/health Không dùng cổng 8080 nếu đó là proxy outbound. --- ## BUILD Build Windows: go build -o tool_facebook.exe . Build Linux: go build -o tool_facebook . --- Cross Compile Windows -> Linux amd64 GOOS=linux GOARCH=amd64 CGO_ENABLED=0 go build -o tool_facebook . --- Windows -> Linux ARM64 GOOS=linux GOARCH=arm64 CGO_ENABLED=0 go build -o tool_facebook . --- Linux -> Windows GOOS=windows GOARCH=amd64 CGO_ENABLED=0 go build -o tool_facebook.exe . --- ## API Endpoint: /api/v1/facebook Parameters: url : Link Facebook username : Username Facebook --- Ví dụ curl "http://127.0.0.1:8787/api/v1/facebook?url=https://www.facebook.com/shopcodevn" curl "http://127.0.0.1:8787/api/v1/facebook?username=shopcodevn" curl "http://127.0.0.1:8787/api/v1/facebook?url=https://www.facebook.com/share/1FnzFuJRpe/" --- Response { "status": "success", "id": "100002839470854", "username": "shopcodevn", "name": "ShopCode.Vn", "url": "https://www.facebook.com/shopcodevn", "author": "ShopCode.Vn", "time_check": "2026-06-11T23:05:29+07:00", "time_elapsed": 0.703489 } --- ## HEALTH CHECK GET /health Response: { "status": "ok", "proxy_outbound": false, "proxy_host": "", "fallback_direct": true } --- ## ENVIRONMENT VARIABLES FB_COOKIE : Cookie Facebook LISTEN : Port HTTP USE_PROXY : Bật proxy PROXY_HOST : Host proxy PROXY_USER : User proxy PROXY_FALLBACK_DIRECT : Fallback direct TIMEOUT : Timeout RETRIES : Retry --- ## COMMAND FLAGS -listen :8787 -proxy-host host:8080 -proxy-user user:pass -proxy-pool 200 -no-proxy -timeout 12 -retries 0 Ví dụ: ./tool_facebook -listen :9000 -no-proxy --- ## SYSTEMD File: /etc/systemd/system/tool-facebook.service Sau đó: sudo systemctl daemon-reload sudo systemctl enable --now tool-facebook sudo systemctl status tool-facebook --- ## REVERSE PROXY Khuyến nghị: * Nginx * Caddy * Traefik Mô hình: Internet ↓ Nginx / Caddy ↓ 127.0.0.1:8787 Nên bật HTTPS khi deploy production. --- ## TROUBLESHOOTING proxyconnect :8080 => Proxy không hoạt động uid_not_found => Cookie hết hạn Build Linux lỗi => Sai GOOS/GOARCH Sửa HTML không đổi => Chưa build lại Mở web không được => Sai cổng LISTEN --- ## BẢO MẬT * Không commit .env * Không commit cookie Facebook * Không public API nếu chưa có auth * Nên đặt sau Nginx/Caddy và HTTPS --- ## AUTHOR ShopCode.Vn API author xuất hiện trong JSON response: { "author": "ShopCode.Vn" } --- ## LICENSE Sử dụng nội bộ hoặc theo thỏa thuận team. Không commit .env chứa cookie thật lên repository công khai.