SELF HOSTING

Dawarich – Công cụ theo dõi vị trí mã nguồn mở

Bạn có muốn kiểm soát dữ liệu vị trí của mình thay vì để Google Timeline quản lý? Dawarich là câu trả lời hoàn hảo! Đây là một ứng dụng web mã nguồn mở, tự lưu trữ (self-hostable), được thiết kế để thay thế Google Timeline và cung cấp bạn quyền kiểm soát hoàn toàn trên dữ liệu vị trí của mình.

Dawarich cho phép bạn:

  • Theo dõi lịch sử vị trí của mình một cách riêng tư và an toàn
  • Trực quan hóa dữ liệu trên bản đồ tương tác với các lớp tùy chỉnh
  • Nhập dữ liệu vị trí từ nhiều nguồn khác nhau như Google Maps, OwnTracks, GPX, GeoJSON
  • Phân tích thống kê chi tiết về số quốc gia và thành phố đã thăm, quãng đường đã đi, thời gian dành cho mỗi nơi
  • Tạo chuyến đi (Trips) với visualization đầy đủ, từ khoảng cách đến thời gian dành
  • Tích hợp ảnh từ Immich hoặc Photoprism để xem ảnh trên bản đồ

Với hơn 7.1k stars trên GitHub, Dawarich đang trở thành một giải pháp tin cậy cho những ai quan tâm đến quyền riêng tư dữ liệu. Bài viết này sẽ hướng dẫn bạn chi tiết cách cài đặt và sử dụng Dawarich trên các hệ điều hành khác nhau.

Map View

Yêu cầu hệ thống

Trước khi bắt đầu cài đặt Dawarich, bạn cần đảm bảo máy tính của mình có các yêu cầu sau:

  • Docker (phiên bản 20.10 hoặc cao hơn)
  • Docker Compose (phiên bản 1.29 hoặc cao hơn)
  • RAM tối thiểu: 2GB (khuyến nghị 4GB)
  • Ổ cứng: Tối thiểu 10GB không gian trống
  • Kết nối internet để tải các thành phần cần thiết
  • Hệ điều hành hỗ trợ: Linux, macOS, Windows (với WSL2)

Hướng dẫn cài đặt Dawarich

Hướng dẫn cài đặt trên Linux

Linux là lựa chọn tối ưu nhất để chạy Dawarich. Dưới đây là các bước cài đặt chi tiết:

  1. Cập nhật hệ thống: Mở terminal và chạy các lệnh sau để đảm bảo hệ thống của bạn được cập nhật:
sudo apt update && sudo apt upgrade -y
  1. Cài đặt Docker: Docker là nền tảng container hóa cần thiết để chạy Dawarich. Chạy lệnh sau:
curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh
sudo usermod -aG docker $USER
  1. Cài đặt Docker Compose
sudo curl -L "https://github.com/docker/compose/releases/download/v2.20.0/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
sudo chmod +x /usr/local/bin/docker-compose
  1. Clone Repository Dawarich
git clone https://github.com/Freika/dawarich.git
cd dawarich
  1. Khởi động Dawarich bằng Docker Compose
docker-compose -f docker/docker-compose.yml up -d
  1. Truy cập ứng dụng

Mở trình duyệt web và truy cập:

http://localhost:3000

Đăng nhập bằng tài khoản mặc định:

Sau đó, bạn có thể thay đổi thông tin đăng nhập tại phần cài đặt tài khoản.

Hướng dẫn cài đặt trên macOS

Nếu bạn sử dụng Mac, hãy làm theo các bước sau:

  1. Cài đặt OrbStack hoặc Docker Desktop cho macOS và cài đặt như bình thường.
  2. Mở Terminal và clone repository
git clone https://github.com/Freika/dawarich.git
cd dawarich
  1. Khởi động Dawarich
docker-compose -f docker/docker-compose.yml up -d
  1. Truy cập ứng dụng: Mở Safari hoặc Chrome và nhập:
http://localhost:3000

Hướng dẫn cài đặt trên Windows

Windows yêu cầu WSL 2 (Windows Subsystem for Linux 2) để chạy Docker. Các bước:

  1. Cài Đặt WSL 2: Mở PowerShell (chạy với quyền Administrator) và chạy:
wsl --install
wsl --set-default-version 2
  1. Cài đặt Docker Desktop cho Windows: Tải Docker Desktop từ https://www.docker.com/products/docker-desktop và cài đặt. Đảm bảo kích hoạt WSL 2.
  1. Clone repository: Mở WSL terminal và chạy:
git clone https://github.com/Freika/dawarich.git
cd dawarich
  1. Khởi động Dawarich
docker-compose -f docker/docker-compose.yml up -d
  1. Truy cập ứng dụng: Mở trình duyệt Chrome/Edge và nhập:
http://localhost:3000

Cách sử dụng Dawarich

Truy cập giao diện chính

Sau khi cài đặt thành công, giao diện chính của Dawarich gồm các phần chính:

  • Map View (Bản Đồ): Hiển thị lịch sử vị trí trên bản đồ tương tác
  • Statistics (Thống Kê): Xem số quốc gia, thành phố đã thăm, tổng quãng đường
  • Imports (Nhập Dữ Liệu): Nhập lịch sử vị trí từ các nguồn khác nhau
  • Trips (Chuyến Đi): Tạo và quản lý các chuyến đi của bạn

Nhập dữ liệu vị trí

Dawarich hỗ trợ nhập dữ liệu từ nhiều nguồn:

  • Google Maps Timeline: Xuất dữ liệu từ Google Takeout
  • OwnTracks: Ứng dụng theo dõi vị trí di động
  • Strava: Dữ liệu hoạt động thể dục
  • GPX/GeoJSON Files: Các định dạng tệp bản đồ tiêu chuẩn
  • Immich hoặc Photoprism: Dữ liệu EXIF từ ảnh

Để nhập dữ liệu:

  1. Truy cập tab “Imports” trong giao diện Dawarich
  2. Chọn nguồn dữ liệu (ví dụ: Google Maps Timeline)
  3. Tải lên tệp dữ liệu hoặc nhập thông tin xác thực
  4. Bấm “Import” để bắt đầu quá trình nhập
  5. Đợi quá trình hoàn tất và xem dữ liệu trên bản đồ

Theo dõi vị trí realtime

Dawarich hỗ trợ theo dõi vị trí thực thời thông qua các ứng dụng di động được hỗ trợ:

  • Dawarich for iOS: Ứng dụng chính thức cho iPhone
  • OwnTracks: Ứng dụng theo dõi vị trí phổ biến
  • GPSLogger: Ứng dụng Android nhẹ
  • Overland: Ứng dụng iOS khác
  • PhoneTrack: Ứng dụng Nextcloud
  • Home Assistant: Tích hợp thông qua Home Assistant

Cài đặt ứng dụng theo dõi trên điện thoại, cấu hình để gửi dữ liệu đến Dawarich instance của bạn, và Dawarich sẽ tự động cập nhật vị trí của bạn theo thời gian thực.

Phân tích thống kê

Tab “Statistics” cung cấp các thông tin chi tiết:

  • Số quốc gia và thành phố đã thăm
  • Tổng quãng đường đã đi
  • Thời gian dành tại mỗi nơi
  • Biểu đồ theo năm và tháng
  • Dữ liệu có thể xuất ra CSV hoặc định dạng khác

Tạo và quản lý chuyến đi

Tính năng “Trips” cho phép bạn:

  1. Tạo chuyến đi giữa hai khoảng thời gian
  2. Xem route, quãng đường và thời gian dành
  3. Thêm ghi chú cho mỗi chuyến đi
  4. Xem ảnh từ Immich hoặc Photoprism nếu có
  5. Xuất chuyến đi thành PDF hoặc định dạng khác

Ví dụ các trường hợp sử dụng

Trường hợp 1: Blogger Du Lịch

Một blogger du lịch có thể sử dụng Dawarich để:

  • Theo dõi lộ trình chuyến đi
  • Tạo bản đồ tương tác để viết bài blog
  • Phân tích thống kê về địa điểm đã thăm
  • Kết hợp ảnh từ các chuyến đi để tạo nội dung hấp dẫn

Trường hợp 2: Các hoạt động ngoài trời

Những người thích hoạt động ngoài trời (hiking, camping, cycling) có thể:

  • Ghi lại các tuyến đường yêu thích
  • Theo dõi tiến độ phiêu lưu
  • Chia sẻ bản đồ với bạn bè (tính năng sắp tới)
  • Xem thống kê về quãng đường đã đi

Trường hợp 3: Nhà phát triển giám sát quyền riêng tư

Các nhà phát triển quan tâm đến quyền riêng tư có thể:

  • Tự lưu trữ tất cả dữ liệu vị trí
  • Không phải lo lắng về dữ liệu được bán cho bên thứ ba
  • Tích hợp Dawarich vào hệ thống nhà của họ
  • Kiểm soát hoàn toàn cơ sở hạ tầng

Những lưu ý quan trọng

  • Không tự động cập nhật: Hãy đọc release notes trước khi cập nhật phiên bản
  • Đang trong quá trình phát triển tích cực: Có thể xảy ra bugs và breaking changes
  • Không xóa dữ liệu gốc: Sau khi nhập vào Dawarich, hãy giữ các tệp dữ liệu gốc
  • Sao lưu trước khi cập nhật: Luôn sao lưu dữ liệu trước khi nâng cấp
  • Chưa sẵn sàng cho môi trường production: Dawarich vẫn còn trong giai đoạn phát triển

Câu hỏi thường gặp (FAQ)

  • Dawarich có hoàn toàn miễn phí không? Có. Dawarich là dự án mã nguồn mở (AGPL-3.0) và miễn phí. Bạn có thể tự do cài đặt trên máy chủ riêng hoặc NAS của mình. Nếu muốn, bạn cũng có thể dùng dịch vụ được quản lý trước là Dawarich Cloud (thu phí) để không phải tự vận hành.
  • Dawarich an toàn và riêng tư như thế nào? Vì bạn tự triển khai Dawarich trên máy chủ của mình, dữ liệu vị trí sẽ do bạn làm chủ. Trừ khi bạn chia sẻ cho ai đó, không ai có thể xem dữ liệu đó. Tuy nhiên, hãy đảm bảo máy chủ của bạn được bảo vệ (cập nhật phần mềm, dùng HTTPS, firewall…). Mã nguồn Dawarich công khai để cộng đồng kiểm tra bảo mật.
  • Có nên cập nhật tự động Dawarich không? Không nên cài đặt cập nhật tự động. Dawarich thường xuyên thay đổi và có thể gây ra sự cố nếu nâng cấp đột ngột. Trước khi cập nhật, hãy đọc kỹ Release Notes (trong GitHub) và thực hiện backup dữ liệu. Sau đó, dùng lệnh docker compose pull && docker compose up -d để cập nhật.
  • Dawarich có hỗ trợ trên mobile không? Dawarich không phải là một app di động, mà là ứng dụng web thân thiện trên trình duyệt di động. Để ghi nhận vị trí di động, bạn cài app Overland (iOS) hoặc OwnTracks/GPSLogger (Android) như hướng dẫn. Trong tương lai, dự án có thể phát triển thêm các app di động riêng.
  • Làm thế nào để đóng góp cho dự án? Dawarich hoan nghênh cộng đồng đóng góp! Bạn có thể tham gia báo lỗi (issue) hoặc gửi mã nguồn (PR) trên GitHub. Có các hướng dẫn chi tiết trong file CONTRIBUTING.md. Ngoài ra, bạn cũng có thể ủng hộ tác giả qua Patreon hoặc Ko-fi.

Dawarich là một giải pháp tuyệt vời cho những ai muốn kiểm soát dữ liệu vị trí của mình thay vì để các công ty lớn quản lý. Với khả năng cài đặt tự lưu trữ, nhập từ nhiều nguồn, và phân tích thống kê chi tiết, Dawarich là công cụ lý tưởng cho bloggers du lịch, nhà phát triển và bất kỳ ai quan tâm đến quyền riêng tư.

Hãy thử cài đặt Dawarich ngay hôm nay và bắt đầu kiểm soát lịch sử vị trí của bạn! Nếu bạn gặp bất kỳ vấn đề nào trong quá trình cài đặt, đừng ngần ngại để lại bình luận dưới đây hoặc tham gia cộng đồng GitHub để nhận hỗ trợ.

Bạn có sử dụng Dawarich hay công cụ tương tự nào khác để theo dõi vị trí của mình không? Hãy chia sẻ kinh nghiệm của bạn trong phần bình luận!

Duy Nghiện
Hãy làm khán giả, đừng làm nhân vật chính :)

You may also like

Nhận thông báo qua email
Nhận thông báo cho
guest

0 Bình luận
Mới nhất
Cũ nhất Nhiều like nhất
Phản hồi nội tuyến
Xem tất cả bình luận