KidGuard v0.9.47

Hướng dẫn dùng KidGuard

Cài lên điện thoại Android của con, mở trang phụ huynh, rồi quản lý cả khi con ra khỏi nhà. Làm theo từng bước, mọi thứ gỡ lại được.

Tải KidGuard máy của con App bố mẹ máy của bạn

Cài lên máy con

  1. Cài APK và mở app. Không cần xóa tài khoản, chưa cần cài đặt gì. Đã dùng được ngay: launcher cho con (bật trên máy), Dọn máy Beta (chỉ cần ghép Gỡ lỗi không dây, app tự chạy pm disable-user trên chính máy) và Bố mẹ quản lý trên máy này (trang phụ huynh ngay trên máy con, ở chế độ xem trước: mục thiếu quyền sẽ mờ và ghi rõ cần quyền gì).
  2. Đặt PIN phụ huynh: form ghép (bước 5) bắt đặt PIN. PIN này khóa trang trên máy con và cho phép ghép thêm máy bố mẹ.
  3. Cấp quyền khi cần, theo bảng chức năng nào cần quyền gì: trợ năng, quyền truy cập dữ liệu sử dụng, quản trị thiết bị, vị trí…
  4. Tùy chọn, mạnh nhất: Device Owner (cách A–D bên dưới). Chỉ bước này mới cần xóa tài khoản của máy (Google, Samsung, Xiaomi…); tài khoản của app (Zalo, Facebook…) được giữ.
  5. Ghép điện thoại hoặc trình duyệt của bố mẹ (Wi-Fi nhà hoặc relay, xem Từ xa).

Có năm cách cài, chọn một. Cách A đến D biến KidGuard thành Device Owner (vai trò Android cho máy công ty): khóa được app, con không gỡ được, không cần root. Cách E không cần bước này nhưng yếu hơn.

Chỉ khi làm Device Owner (cách A–D): Android chỉ cho app làm Device Owner khi máy không có tài khoản nào. KidGuard giữ được tài khoản của app, còn tài khoản của máy thì phải xóa trước.

Tài khoản của máy (Google, Samsung, Xiaomi, Oppo/HeyTap…): vào Cài đặt → Tài khoản trên máy con, xóa chúng. Cài xong đăng nhập lại, mọi thứ quay về.

Giữ đăng nhập các app (Zalo, Facebook, Telegram…): tự động. KidGuard tắt tạm các app đó, máy khởi động lại một lần (khoảng 1 phút), cài xong rồi bật lại. Cách B (QR) không cần: máy mới chưa có tài khoản. Cách B, C, D đều làm được; cách tự cài trên máy sẽ cài tiếp sau khi mở khóa màn hình, và báo bằng thông báo. Nếu có tài khoản của máy, KidGuard dừng và nói rõ tài khoản nào cần xóa.

Làm tay (nếu cần): adb shell pm disable-user --user 0 <tên gói>, chờ 15 giây, adb shell sync, adb reboot, chờ khoảng 30 giây sau khi máy lên, cài Device Owner, rồi adb shell pm enable <tên gói>. Xem tài khoản thuộc app nào: adb shell dumpsys account.

A. Ngay trên điện thoại Khuyên dùng

Cần: Android 11+, Wi-Fi. Không cần máy tính. Tài khoản của máy (Google, Samsung…) phải xóa trước: KidGuard dừng và nói rõ tài khoản nào cần xóa.

  1. Tải file APK trên máy con, cài và mở KidGuard.
  2. Bấm Cài đầy đủ không cần máy tính (Android 11+).
  3. Bật Tùy chọn nhà phát triển: vào Giới thiệu về điện thoại, bấm 7 lần vào Số hiệu bản tạo (Build number).
  4. Trong Tùy chọn nhà phát triển, bật Gỡ lỗi không dây và cho phép Wi-Fi này.
  5. Quay lại KidGuard, bấm Hiện ô nhập mã ở thông báo. Rồi trong Gỡ lỗi không dây, bấm Ghép thiết bị bằng mã ghép nối.
  6. Kéo thanh thông báo xuống, bấm Nhập mã ghép và gõ mã 6 số đang hiện.
  7. KidGuard tự làm phần còn lại, rồi tắt Gỡ lỗi không dây.

Mã được nhập ở thông báo vì hộp thoại ghép nối tự tắt khi rời màn hình Cài đặt. Nếu thông báo không hiện, gõ mã ngay trong KidGuard.

B. Quét mã QR

Cần: máy mới hoặc vừa khôi phục cài đặt gốc, Android gần gốc (Pixel, Samsung, Nokia…).

  1. Bật máy con, dừng ở màn hình chào mừng.
  2. Chạm 6 lần vào một chỗ trống trên màn hình. Máy mở trình quét QR.
  3. Quét mã QR cài đặt (mở trên máy tính hoặc điện thoại khác).
  4. Máy tự tải KidGuard qua Wi-Fi và thiết lập.
  5. Mở KidGuard, làm nốt danh sách ngắn trên màn hình.

Một số giao diện hãng bỏ màn hình chạm 6 lần (ví dụ Oppo / Realme ColorOS trên Android 8–9). Khi đó dùng cách C.

C. Máy tính và cáp USB

Cần: máy tính có Chrome hoặc Edge, cáp USB. Không cần cài adb. Khoảng 3 phút.

  1. Trên máy con: xóa tài khoản của máy (Google, Samsung, Xiaomi, Oppo…) trong Cài đặt → Tài khoản. Tài khoản của app cứ để nguyên.
  2. Bật Tùy chọn nhà phát triển: Cài đặt → Giới thiệu về điện thoại, chạm 7 lần vào Số hiệu bản tạo.
  3. Trong Tùy chọn nhà phát triển, bật Gỡ lỗi USB. Xiaomi / Redmi / POCO: bật thêm Gỡ lỗi USB (Cài đặt bảo mật) và Cài qua USB.
  4. Cắm cáp vào máy tính, mở trang cài đặt trong Chrome hoặc Edge.
  5. Bấm Kết nối điện thoại, chọn máy trong hộp hiện ra. Trên máy con bấm Cho phép (tick “Luôn cho phép máy tính này”).
  6. Bấm Bắt đầu cài. Xong, trang hiện địa chỉ để bố mẹ mở.

D. Dòng lệnh

Cần: macOS, Linux hoặc Windows, cáp USB.

  1. Chuẩn bị máy con như cách C, bước 1–3, rồi cắm cáp.
  2. Tải mã nguồn về máy tính (hoặc chỉ tải riêng file setup.sh / setup.ps1).
  3. Chạy lệnh:
    git clone https://github.com/HoangTran0410/kidguard && cd kidguard
    scripts/setup.sh
    
    # Windows
    powershell -ExecutionPolicy Bypass -File scripts\setup.ps1
  4. Script tự tải adb nếu máy chưa có, và tải bản KidGuard mới nhất (có kiểm tra SHA-256) nếu không thấy file APK. Thêm -y để bỏ qua câu hỏi.
  5. Script làm 8 bước: cài app, đặt Device Owner, cấp quyền xem thời gian dùng app và ghi cài đặt bảo mật, bật Trợ năng, cho chạy nền, mở app, in địa chỉ cho bố mẹ.

E. Chế độ cơ bản Yếu hơn

Cần: mọi Android 8+. Không cần máy tính, không cần xóa tài khoản. Dành cho máy cũ không có màn hình QR, không có máy tính hay cáp.

  1. Cài file APK, mở KidGuard, làm theo danh sách Việc cần làm ngay trên màn hình.
  2. Bật lần lượt từng mục: quản trị thiết bị, Trợ năng, truy cập dữ liệu sử dụng, vị trí (chọn Luôn cho phép), thông báo, pin.
  3. Mỗi nút mở đúng màn hình hệ thống: bật lên rồi bấm Quay lại.

Vì sao yếu hơn: app bị khóa sẽ bị đóng về màn hình chính thay vì xám đi.

  • Không có: bộ lọc DNS gia đình, chặn cài app / Gỡ lỗi USB, khóa chế độ máy bay / vị trí / giờ, khởi động lại máy, Tailscale.
  • Con khởi động vào Safe Mode hoặc tắt được Trợ năng là hết chặn. Trang phụ huynh báo đỏ, app bố mẹ gửi thông báo.

Sau này chuyển sang Device Owner được bằng cách A, C hoặc D (phải xóa tài khoản như cài mới). Luật và ghép nối giữ nguyên.

Mở trang phụ huynh

Cài xong, màn hình cuối trên máy con hiện mã ghép 6 số và mã QR trong 10 phút. Hết 10 phút hoặc muốn ghép sau: bố mẹ giữ nút Bố mẹ: hiện mã ghép 5 giây trên màn hình KidGuard.

  1. Trên điện thoại của bạn (cùng Wi-Fi với máy con), quét mã QR bằng camera. Trang mở ra với mã điền sẵn.
  2. Hoặc mở trình duyệt, vào http://<IP máy con>:8770 và gõ mã 6 số.
  3. Đặt PIN phụ huynh ngay trong form ghép. Chưa có PIN thì máy con không cho ghép thêm trình duyệt khác.
  4. Đăng nhập lại tài khoản trên máy con (nếu đã xóa) và rút cáp.
  5. Xiaomi, Oppo, Vivo, Samsung: trên máy con bấm Cài đặt pin / tự khởi động, cho KidGuard chạy nền.
  6. Muốn quản lý cả khi con ra ngoài: xem Khi con ra khỏi nhà.

Oppo / Realme / OnePlus (ColorOS): mở Đa nhiệm, kéo thẻ KidGuard xuống để khóa (biểu tượng ổ khóa). Trong Quản lý điện thoại, cho KidGuard “Tự khởi chạy” và chạy nền. Vuốt KidGuard khỏi Đa nhiệm trên ColorOS sẽ tắt hẳn app.

Tìm chức năng: trên trang phụ huynh, bấm ô Tìm chức năng ở trên cùng (hoặc phím /) rồi gõ vài chữ, ví dụ relay, giờ ngủ, wifi. Hướng dẫn này ghi “tìm …” thay cho đường đi trong menu, vì menu có thể đổi chỗ.

Lần đầu: 4 bước nhanh. Ghép xong, trang dẫn bạn qua mức bắt đầu (Nhẹ nhàng, Cân bằng hay Nghiêm), app hay dùng (cho phép, bình thường hoặc chặn), giờ ngủ và giới hạn mỗi ngày, và con thấy gì. Bấm Xong mới lưu. Làm lại bất cứ lúc nào: tìm thiết lập lại.

Ở Wi-Fi nhà trang chạy HTTP thường: chỉ dùng ở mạng bạn tin tưởng. Mỗi trình duyệt ghép một lần bằng mã ghép 6 số, ghép thêm cần PIN phụ huynh.

App bố mẹ (Android)

Trình duyệt là đủ để quản lý. App bố mẹ thêm thông báo (SOS, xin thêm giờ, Trợ năng bị tắt, mất kết nối) và hiện dữ liệu gần nhất khi máy con mất mạng.

  1. Tải app bố mẹ và cài lên điện thoại của bạn.
  2. Mở app, bấm Thêm máy của con.
  3. Ở nhà: gõ địa chỉ hiện trên màn hình KidGuard của con, rồi mã ghép 6 số (giữ nút Bố mẹ: hiện mã ghép 5 giây nếu chưa thấy).
  4. Ngoài nhà: bấm Quét QR và quét mã trên máy con. Chỉ nhận link của KidGuard.
  5. Phụ huynh còn lại: trên trang của bạn tìm relay, bấm Mời phụ huynh khác. Người đó quét mã QR (hoặc mở link) và nhập tên. Lời mời dùng một lần, hết hạn sau 10 phút.
  6. Mỗi người có quyền riêng: mục đó liệt kê ai đang có quyền, đổi tên hoặc xoá từng người. Lệnh và luật ghi tên người gửi trong nhật ký máy con. Trình duyệt hỏi lại PIN gia đình mỗi 12 giờ.
  7. Có từ 2 con: mục Tổng quan hiện tất cả các con trên một trang.

Dễ hơn: bot Telegram gửi SOS và xin thêm giờ tới ngay, không cần app hay build.

Thông báo xin thêm giờ có nút +15 / +30 phút và Từ chối ngay trên thông báo. App kiểm tra khoảng 15 phút một lần. Muốn SOS tới trong vài giây (qua Worker và Firebase), cần tự build app: xem README.

Kiểm tra thông báo: app có thẻ sức khỏe (Cài đặt) cho biết thông báo có tới được bạn không (quyền, kênh, tiết kiệm pin, lần kiểm tra cuối) và sửa từng lỗi bằng một chạm. Máy con mất mạng hiện “mất mạng từ HH:mm”.

Bố mẹ dùng iPhone: không có app, dùng trình duyệt (Safari) là đủ.

Khi con ra khỏi nhà

Ở nhà, trang nói chuyện thẳng với máy con qua Wi-Fi, không cần cài gì. Khi con ở trường hay đi chơi có 3 cách, đều miễn phí, dùng một hay kết hợp đều được. Relay chung đã bật sẵn ngay khi ghép, nên không làm gì thì trang vẫn mở được từ xa.

  • Chỉ muốn nhận báo và bấm nhanh (cho thêm giờ, khóa, xem vị trí): bot Telegram.
  • Muốn mọi thứ như ở nhà (xem màn hình trực tiếp, nghe xung quanh): Tailscale.
  • Chỉ cần trình duyệt: relay (đã bật sẵn; tự tạo relay riêng nếu không muốn dữ liệu đi qua máy chủ của tác giả).
Bot TelegramTailscaleRelay
Cài đặt~2 phút: tạo bot, dán token~5 phút, một lần: app Tailscale trên máy bố mẹ, dán 1 khóaKhông cần (relay chung bật sẵn). Relay riêng: ~3 phút trên máy tính
Dùng bằngApp Telegram, nút bấmTrang phụ huynh (app Tailscale bật)Trang phụ huynh, trình duyệt bất kỳ
Tốc độ~1 giâyTức thìThường vài giây (khi mất kết nối nhanh: ~20 giây, tắt màn hình ~60 giây)
Màn hình / ngheChụp màn hình, ghi âm 10–60 giâyXem trực tiếp, nghe trực tiếpXem trực tiếp, nghe trực tiếp
Báo SOS, xin giờTới ngay trong TelegramTrong trang / app bố mẹTrong trang / app bố mẹ
Dữ liệu đi quaMáy chủ TelegramKhông ai (mã hóa đầu cuối)Relay chung: Cloudflare của tác giả. Relay riêng: chỉ tài khoản của bạn
CầnMáy con có internet. Mỗi bé 1 botDevice Owner (không có ở chế độ cơ bản)Không
Con thấyKhông có gì (thông báo khi đang ghi âm)Biểu tượng chìa khóa trên thanh trạng thái (VPN)Không có gì

Bot Telegram, Tailscale và relay riêng đều bật khi đang ở nhà, trong trang phụ huynh: tìm telegram, tìm tailscale hoặc tìm relay.

Bot Telegram Dễ nhất

Điều khiển và nhận báo ngay trong Telegram: xem tình hình, cho thêm giờ, khóa máy, tìm vị trí, chụp màn hình, chặn app bằng nút bấm. SOS, xin thêm giờ (có nút Cho / Từ chối), nhập sai PIN (kèm ảnh) tự gửi tới. Không cần Tailscale hay relay: máy con tự chạy bot. Mỗi bé 1 bot riêng.

  1. Tạo bot (1 phút). Trên điện thoại bố mẹ, mở @BotFather trong Telegram, bấm Bắt đầu, gửi /newbot. Gửi tên bot (vd: Nhà Bin), rồi tên đăng nhập kết thúc bằng bot (vd: nhabin_kidguard_bot; bị trùng thì thêm số).
  2. Copy token. BotFather trả về 1 dòng dạng 123456789:AAH…: chạm vào là copy. Nhấn giữ cả tin → Sao chép cũng được. Giữ kín token.
  3. Dán vào trang phụ huynh. tìm telegram, dán vào ô token (dán cả tin cũng được, trang tự lấy token), bấm Kết nối.
  4. Liên kết. Trang hiện nút Mở Telegram và liên kết và mã QR. Bấm nút (hoặc quét QR bằng camera điện thoại), Telegram mở bot, bấm Bắt đầu. Bot chào và hiện Menu.
  5. Thêm người nhận (bố, mẹ, ông bà, tối đa 5): bấm Mã khác và gửi link cho người đó.

Dùng: bấm 📋 Menu để bấm nút, hoặc gõ lệnh (/status, /bonus 30, /lock, /locate…); /requests xem yêu cầu đang chờ, /lost bật / tắt chế độ thất lạc, /quiet chọn mức báo; /code gửi mã mở khoá 6 số để đọc cho con (không cần mở app Authenticator); /help xem hết lệnh, /lang đổi Tiếng Việt / English. Gỡ quản lý, huỷ ghép, xoá dữ liệu không làm được qua Telegram.

Có 2 bé thì sao?

Tạo 2 bot (vd: Nhà Bin, Nhà Na), mỗi bot dán vào trang của bé đó. 1 bot chỉ chạy được trên 1 máy con.

Báo “Token sai” hoặc “đang được nơi khác dùng”?

Copy lại cả tin của BotFather và dán. “Nơi khác dùng” nghĩa là bot đã gắn cho máy khác: tạo bot mới cho bé này. Lỡ lộ token: gửi /revoke cho BotFather lấy token mới, dán lại.

Bấm Bắt đầu mà bot im?

Mã liên kết dùng được 15 phút: bấm Mã khác. Máy con phải có mạng (bot chạy trên máy con).

Tin nhắn đi qua đâu?

Qua máy chủ Telegram (không mã hoá đầu cuối). Token chỉ lưu trên máy con. Tắt bot: tìm telegram → Tắt bot, máy con quên token.

Tailscale Đủ tính năng nhất

Máy con tự cài Tailscale và vào mạng riêng của bạn. Không cần Cloudflare. Cần Device Owner (không có ở chế độ cơ bản).

  1. Trên điện thoại của bạn: cài app Tailscale, đăng nhập bằng tài khoản Google / Apple / Microsoft. Việc này cũng tạo tài khoản Tailscale miễn phí.
  2. Mở trang Keys → Generate access token → Generate → chép khóa.
  3. Ở nhà (cùng Wi-Fi với máy con), mở trang phụ huynh: tìm tailscale.
  4. Dán khóa vào ô tskey-api-… / tskey-auth-…, đặt tên máy nếu muốn (ví dụ kid-an), bấm Bật.
  5. Máy con tự tải app Tailscale chính hãng (kiểm tra SHA-256), cài im lặng, vào mạng của bạn rồi ẩn app. Mất khoảng 1 phút.
  6. Thẻ hiện Đã kết nối, địa chỉ dạng http://100.x.y.z:8770 và nhãn không hết hạn.
  7. Trên điện thoại của bạn (bật Tailscale), mở địa chỉ đó. Nhiều con: thêm từng địa chỉ bằng Thêm máy của con.

Access token hay auth key?

  • API access token (tskey-api-…), khuyên dùng: máy con tự tạo khóa riêng dùng một lần và tự tắt hạn 180 ngày của Tailscale. Token chỉ dùng lúc cài rồi bị xóa, không lưu.
  • Auth key (tskey-auth-…): cũng được, nhưng bạn phải tự tắt hạn một lần. Vào trang Machines → dòng máy con → ⋯ → Disable key expiry. Không làm thì sau 180 ngày Tailscale đăng xuất máy con. Trang phụ huynh sẽ nhắc.

Nên biết

  • Bật hoặc đổi khóa chỉ làm được khi ở nhà. Khóa nằm trên máy con, không bao giờ đi qua Worker.
  • Con không tắt được VPN, không đổi được cài đặt VPN, không gỡ được Tailscale. Bộ lọc DNS an toàn vẫn chạy.
  • Tắt: bấm Tắt và gỡ Tailscale (hoặc Gỡ quyền quản lý). Sau đó vào trang Machines xóa máy con, vì app đã gỡ không tự đăng xuất được.

Relay (Cloudflare Worker)

Đã bật sẵn: ghép xong là trang dùng relay chung của KidGuard, mở được từ bất cứ đâu (link: tìm relay trên trang). Trạng thái, vị trí và luật của con đi qua tài khoản Cloudflare của tác giả, hạn mức miễn phí dùng chung với mọi người. Không muốn vậy: tự tạo relay riêng như dưới, hoặc tắt relay trong Cài đặt.

Tự tạo relay riêng

Một Cloudflare Worker nhỏ trong tài khoản Cloudflare miễn phí của bạn, chuyển lệnh, trạng thái và màn hình trực tiếp. Hình màn hình chỉ nằm trong bộ nhớ của Worker, không lưu lại. Máy bố mẹ chỉ cần trình duyệt.

Cần: máy tính có Node.js 18+. Tài khoản Cloudflare tạo miễn phí lúc đăng nhập.

  1. Trên máy tính, chạy:
    git clone https://github.com/HoangTran0410/kidguard && cd kidguard
    scripts/relay.sh
    
    # Windows
    powershell -ExecutionPolicy Bypass -File scripts\relay.ps1
  2. Script làm 3 bước: cài công cụ (lần đầu khoảng 1 phút), mở trang đăng nhập Cloudflare trên trình duyệt (nếu chưa đăng nhập), rồi deploy.
  3. Tài khoản mới có thể được hỏi chọn tên miền con workers.dev: trả lời, tên này nằm trong địa chỉ relay.
  4. Script in ra địa chỉ: Relay ready: https://kidguard.<tên-bạn>.workers.dev.
  5. Ở nhà, mở trang phụ huynh: tìm relay, mục relay riêng (Cloudflare Worker). Dán địa chỉ, bấm Bật.
  6. Trang hiện link điều khiển từ xa. Mở link đó trên điện thoại của bạn (lưu lại, đừng gửi cho ai), hoặc dán vào app bố mẹ.
  • Cập nhật: chạy lại script. Gỡ khỏi tài khoản: scripts/relay.sh --delete (Windows: -Delete).
  • Gói miễn phí: 100.000 request mỗi ngày, mỗi máy con dùng khoảng 4.300. Lệnh thường tới trong vài giây.

Relay chung

Địa chỉ https://kg-relay.99-hoangtran.workers.dev, bật sẵn. Hạn mức miễn phí mỗi ngày dùng chung với mọi người nên hiếm khi có thể hết trong ngày: khi đó dùng bot Telegram, Tailscale hoặc relay riêng.

Đồng hồ Amazfit (Zepp OS)

Bản app đồng hồ (thư mục watch/) cho bố mẹ xem giờ còn lại, duyệt xin thêm giờ, khóa, đổ chuông và xem vị trí ngay trên cổ tay. Kết nối kiểu ghép TV: trên đồng hồ mở KidGuard, bấm Kết nối để lấy mã 6 số, rồi trên trang phụ huynh tìm đồng hồ, nhập mã và bấm Kết nối. Cần bật relay cho bé đó. Mã hết hạn sau 10 phút, đồng hồ tự lấy mã mới. Không có mã thì vẫn dán được link relay ở trang cài đặt của app Zepp.

Tính năng

Tất cả có trong bản hiện tại, không gói trả phí.

Thời gian

Giới hạn mỗi ngày
Một con số, hoặc theo từng thứ. Hết giờ, mọi app (trừ “Luôn cho phép”) khóa đến nửa đêm. Thêm +15 / +30 / +60 phút cho hôm nay.
Giờ ngủ, lịch
Giờ ngủ mỗi ngày, cộng khung giờ theo thứ (giờ học thứ 2–6), qua được nửa đêm.
Báo trước khi khóa
Con nhận thông báo 5 phút và 1 phút trước khi hết giờ, đến giờ ngủ hay lịch khóa.
Thêm giờ luôn có tác dụng
Duyệt xin thêm giờ lúc giờ ngủ hay giờ học: máy con mở trong N phút, rồi khóa lại. Bấm Kết thúc để khóa sớm.
Giờ ngủ từng đêm, +1 phút
Giờ ngủ riêng cho mỗi đêm (đêm đi học khác cuối tuần). Khi khóa, con tự xin được +1 phút để lưu bài, một lần mỗi lần khóa. Tắt được.
Tạm dừng ngay
30 phút, 1 giờ, hoặc đến 6 giờ sáng.
Xin thêm giờ
Con chọn 15 / 30 / 60 phút kèm lý do, bố mẹ duyệt hoặc từ chối.
Việc nhà
Bố mẹ liệt kê việc (“Rửa bát +20 phút”), con chọn khi xin giờ. Duyệt kèm lời nhắn nếu muốn.
Mã mở khóa
6 số từ Google Authenticator, không cần mạng ở cả hai máy. Con được 15–120 phút không giới hạn, mỗi mã dùng một lần.
Mẫu luật
Ngày đi học, Cuối tuần, Nghỉ hè, Thi cử, hoặc tự lưu. Áp cho một hay nhiều con.

Ứng dụng

Từng ứng dụng
Bình thường, N phút mỗi ngày, Chặn, hoặc Luôn cho phép. Chọn nhiều app để đổi một lần.
Nhóm ứng dụng
Số phút chung cho cả nhóm (“Game”, “Mạng xã hội”) và/hoặc giờ được dùng.
Ứng dụng mới
Có thể khóa đến khi bố mẹ duyệt.
Dọn máy
Ẩn app hãng cài sẵn con không dùng, xem app nặng nhất, xóa dữ liệu app. Cần Device Owner.
Tự cập nhật
Mỗi ngày máy con kiểm tra bản mới trên GitHub, tải về và kiểm SHA-256. Tắt hoặc cập nhật ngay trong Cài đặt.

Vị trí và an toàn

Vị trí
Định vị ngay, vị trí luôn bật (con không tắt được), lịch sử 7 ngày trên bản đồ OpenStreetMap.
Vùng
Nhà, Trường… có bán kính: báo khi con đến hoặc rời đi.
SOS
Nút đỏ trên máy con: trang phụ huynh hiện thời gian và vị trí mới nhất, app bố mẹ báo.
Xem màn hình
Màn hình con trực tiếp (Android 11+, ~3 khung hình/giây). Con luôn được báo là bố mẹ đang xem.
Điều khiển từ xa
Chạm, vuốt, nhấn giữ, Quay lại / Màn hình chính / Đa nhiệm, gõ chữ.
Nghe xung quanh
Tối đa 10 phút mỗi lần, qua Wi-Fi nhà, Tailscale hoặc relay. Con luôn biết: tiếng bíp, thông báo, chấm micro của Android.
Chế độ thất lạc
Tab Vị trí: bật là máy khóa ngay và khóa lại mỗi lần mở, màn hình khóa hiện lời nhắn + số của bạn, định vị 5 phút một lần, đổ chuông 5 phút mỗi 15 phút. Tắt thì mọi thứ về như cũ. Báo cả khi đổi SIM.
Mức báo
Chỉ SOS, mất máy, mở khóa bằng mã và xin giờ báo to; còn lại báo êm. Telegram: /quiet chọn tất cả / quan trọng / chỉ SOS cho từng người. App bố mẹ báo “offline từ HH:mm” và bỏ qua giờ ngủ của con.
Cảnh báo
Đến / rời vùng, pin còn 15 %, cài app mới, đổi giờ máy.

Nhìn lại

Lịch sử
Thời gian dùng 7 ngày, top app mỗi ngày, báo cáo tuần cho từng con.
Nhiều con
Tổng quan: mỗi con một thẻ, vị trí mọi con trên một bản đồ, 7 ngày đặt cạnh nhau.
Luật của con
Con xem được luật của mình và nhật ký bố mẹ đã đổi gì.
Ngôn ngữ
Tiếng Việt và English ở trang phụ huynh và cả hai app.

Màn hình chính cho con

Thao tác
Giữ một biểu tượng: menu hiện trên nền tối, có Sửa màn hình chính. Kéo một app đè lên app khác để gom thư mục. Ở chế độ sửa, nút trừ để bỏ (có hỏi lại), chọn nhiều để gom hoặc bỏ cùng lúc.
Thư mục, thư viện
Thư mục mở từ chính biểu tượng, giữ để xếp lại. Thư viện ứng dụng ở trang cuối: gợi ý, mới cài, theo nhóm, tìm kiếm.
Widget
Đồng hồ, lịch tháng, giờ còn lại, thời khóa biểu (sáng/chiều, giờ chuông, cả tuần), việc nhà, ghi chú, pin, thời tiết, khóa màn hình; thêm cả widget của app khác.
Trang “Hôm nay”
Vuốt phải từ trang 1. Nút SOS và Gọi luôn ở trên. Thẻ Bây giờ (tiết đang học, còn bao lâu tới giờ ngủ), Thời gian dùng máy (xin thêm giờ), Ngày mai (từ 17h), việc nhà, ghi chú, File với bố mẹ (con gửi file cho bố mẹ ngay tại đây). Tuỳ chỉnh thẻ ở cuối trang; tắt cả trang trong Tuỳ chỉnh.
Tuần này
Thẻ “Tuần này của bạn” trên trang Hôm nay: số ngày trong giới hạn, chuỗi hiện tại, danh sách đã xong. Chưa có gì để khen thì thẻ ẩn.
Yêu cầu
Mỗi con chỉ một yêu cầu đang mở: con thấy đang chờ và bấm Nhắc lại, rồi thấy câu trả lời. Con cũng xin mở được app đang bị chặn hoặc app mới. Bạn trả lời bằng N/2, N hoặc 2N phút, trên trang, trong app bố mẹ hoặc Telegram (/requests); trả lời xong mọi nơi cùng cập nhật. Yêu cầu chưa trả lời hết hạn lúc nửa đêm.
Tuỳ chỉnh
Giữ chỗ trống trên màn hình chính: Tiện ích, Sửa màn hình chính, Tuỳ chỉnh. Trong Tuỳ chỉnh: hình nền (làm mờ, làm tối), số cột, cỡ biểu tượng (số hàng không đổi), hình biểu tượng (tròn, vuông, squircle), cỡ chữ, phông, sáng/tối, màu nhấn, chấm thông báo, hiệu ứng Đầy đủ / Nhẹ / Tự động. Có Hoàn tác ngay dưới mục vừa đổi.
Bố cục đã lưu
Lưu bố cục hiện tại (tối đa 5, đặt tên): cả trang, dock, giao diện và ảnh nền. Chạm một bố cục để đổi cả màn hình chính, có hoàn tác. Chỉ lưu trên máy.
Trung tâm điều khiển
Vuốt xuống ở nửa phải màn hình chính: Wi-Fi, Bluetooth, máy bay, dữ liệu, đèn pin, tự xoay, Không làm phiền, độ sáng, âm lượng, đang phát, Học bài. Nửa trái là thông báo.
Học bài
Con tự bật: chỉ còn app học trên màn hình, bật Không làm phiền nếu được cho phép. App bố mẹ chặn vẫn bị chặn.
App đang ẩn
Trong thư viện ứng dụng, nút ⋮ cạnh ô tìm kiếm: danh sách app đang ẩn kèm lý do (bố mẹ chặn, chờ duyệt, giờ học...). Bị đóng trang nào thì có thông báo ngắn nói vì sao.
Không cần quản lý?
Launcher này có app riêng: KidGuard Home (dưới 1 MB). Cài cho máy nào cũng được, không cần bố mẹ, không xin quyền đặc biệt; bỏ SOS, xin giờ, việc nhà, file. Mở app, bấm Sửa trên dải báo để đặt làm màn hình chính.
Đã có KidGuard?
Không cần KidGuard Home: launcher có sẵn. Cài KidGuard sau thì bố cục, ghi chú, thời khoá biểu và hình nền tự chuyển sang (KidGuard Home 0.9.10 trở lên); widget của app khác phải thêm lại.
Xiaomi, Redmi, POCO
Màn hình chính không phải của Xiaomi thì điều hướng chuyển thành 3 nút: hệ thống làm vậy, không có cài đặt giữ cử chỉ. Chọn lại màn hình chính Xiaomi là có cử chỉ lại.

Giữ chắc

Khó phá
Chặn gỡ app, buộc dừng, khôi phục gốc từ Cài đặt, Safe Mode, người dùng mới, đổi giờ, chế độ máy bay. Có watchdog tự bật lại.
Chống khôi phục gốc
Device Owner, Android 11+. Sau khi khôi phục từ recovery, máy đòi tài khoản Google của bố mẹ. Cần ID số của tài khoản (không phải email); trang chỉ cách lấy. ID sai có thể khóa máy vĩnh viễn sau khi khôi phục. Tự tắt khi gỡ quyền quản lý.
Còn mấy lần nhập PIN
Nhập sai PIN trên máy con thì máy báo còn mấy lần. Quên PIN? chỉ cách đặt lại (chờ 24 giờ, có cảnh báo).
Biên nhận lệnh
Mỗi lệnh hiện đã gửi, rồi đã chạy HH:mm, bị từ chối hoặc hết hạn (có nút Gửi lại). PIN sai qua relay không bị nhớ.
Tùy chọn
Lọc DNS gia đình (AdGuard / Cloudflare / CleanBrowsing), chặn cài app, chặn Gỡ lỗi USB.
Lệnh nhanh
Khóa màn hình, đổ chuông, tin nhắn toàn màn hình, khởi động lại máy.

App bị khóa dùng cơ chế có sẵn của Android: biểu tượng xám đi, mở ra thấy báo bố mẹ đã tạm dừng.

Con dùng iPhone / iPad

Không có KidGuard cho iOS: Apple không cho app bên thứ ba xem màn hình, điều khiển máy hay khóa app khác. Dùng thứ có sẵn, miễn phí:

  • Thời gian sử dụng (Screen Time) + Chia sẻ trong gia đình: giới hạn, giờ nghỉ, giới hạn app, lọc web người lớn, duyệt mua hàng, “xin thêm giờ”, quản lý từ iPhone của bố mẹ.
  • Tìm (Find My): vị trí của con.

Con dùng Android còn bố mẹ dùng iPhone thì vẫn quản lý được bằng trình duyệt trên iPhone.

Gỡ KidGuard

  1. Trang phụ huynh: tìm nguy hiểm → Gỡ quyền quản lý…
  2. Mọi app được mở khóa, mọi hạn chế được gỡ. Đã bật Tailscale thì Tailscale cũng được gỡ.
  3. Gỡ app KidGuard như app thường.

Khi có lỗi

Bị Play Protect chặn (“Ứng dụng bị chặn để bảo vệ thiết bị”)?

Play Protect chặn app cài từ trình duyệt hay trình quản lý file khi app dùng Trợ năng. Trên máy con: Play Store → ảnh đại diện → Play Protect → ⚙ → tắt Quét ứng dụng bằng Play Protect. Cài và thiết lập KidGuard, rồi bật lại. Cài bằng mã QR thì không bị chặn (máy tự tải app).

Màn hình chào mừng không có chỗ chạm 6 lần?

Một số giao diện hãng bỏ màn này (ví dụ Oppo / Realme ColorOS trên Android 8–9). Dùng máy tính và cáp USB.

Máy dưới Android 11 không tự cài được?

Cách A cần Android 11+. Dùng máy tính (cách C hoặc D), khôi phục gốc rồi quét QR, hoặc dùng chế độ cơ bản.

Không mở được trang phụ huynh?

Kiểm tra địa chỉ trên màn hình KidGuard của con (cổng mặc định 8770). Điện thoại của bạn phải cùng Wi-Fi, hoặc cùng mạng Tailscale, với máy con.

Bộ lọc DNS có làm con mất Internet không?

Không. Nếu máy chủ lọc bị từ chối, hoặc mạng có Internet nhưng DNS-over-TLS bị chặn 90 giây, KidGuard quay về DNS thường trong 30 phút và trang phụ huynh báo lý do.

Vì sao có app hiện màn hình đen khi xem từ xa?

App đánh dấu màn hình là bảo mật (ngân hàng…) luôn hiện đen.

Con có tự gỡ được không?

Không gỡ được từ Cài đặt. Khôi phục gốc bằng phím cứng (recovery) thì vẫn được: KidGuard mất, trang phụ huynh báo mất kết nối.

Android 8–10 có hạn chế gì?

Xem màn hình và điều khiển từ xa cần Android 11+. Trên Android 8–10 con có thể buộc dừng KidGuard (khởi động lại máy là chạy lại).

Gặp lỗi khác hoặc có ý tưởng?

Gửi tại GitHub Issues. Chi tiết kỹ thuật: docs/protocol.md.