OpenQR

OpenQR

Trình tạo mã QR miễn phí, mã nguồn mở, không hình mờ. Chạy hoàn toàn trong trình duyệt của bạn — không theo dõi, không đăng ký, không giới hạn.

Hầu hết các trình tạo mã QR trực tuyến dụ bạn bằng chữ "miễn phí" rồi sau đó thêm hình mờ, giới hạn kích thước tải xuống, giấu tính năng xuất vector sau tường phí, hoặc định tuyến mã của bạn qua máy chủ của họ để nó ngừng hoạt động khi bạn ngừng trả phí. Mã QR chỉ là một tiêu chuẩn mở (ISO/IEC 18004) không tốn chi phí để tạo. OpenQR giữ nguyên điều đó.

Kho lưu trữ này là công cụ tạo cơ bản — bản triển khai tham chiếu mã nguồn mở. Nó được thiết kế nhỏ gọn và dễ fork.

Nếu OpenQR hữu ích với bạn, một sao trên kho lưu trữ sẽ giúp người khác tìm thấy nó. Đó là toàn bộ yêu cầu.

Phiên bản lưu trữ: API miễn phí, máy chủ MCP và mã có thể chỉnh sửa

Mọi thứ trong kho này đều miễn phí và sẽ luôn miễn phí, không hình mờ và không hết hạn. Bản dựng lưu trữ tại openqr.uk thêm một lớp tài khoản tùy chọn cho những người muốn mã có thể chỉnh sửa và tự động hóa:

• Mã QR động / có thể chỉnh sửa với phân tích quét. Thay đổi đích đến sau khi bạn đã in. 1 mã miễn phí trên tài khoản miễn phí (7 ngày quét theo quốc gia); 25 mã có thể chỉnh sửa trên gói Pro với giá £9/tháng hoặc £90/năm, cũng mở khóa cửa sổ phân tích quét 90 ngày cùng chi tiết thành phố và khu vực, phân tích thiết bị và nguồn giới thiệu với xuất CSV, tên miền phụ có thương hiệu và mã được bảo vệ bằng mật khẩu. Người đăng ký hiện tại giữ nguyên gói và giá của họ.
• API REST miễn phí. Tạo mã và quản lý mã động theo chương trình. Đặc tả OpenAPI tại /openapi.json; tài liệu tương tác tại openqr.uk/api.
• Máy chủ MCP lưu trữ tại https://openqr.uk/mcp (Streamable HTTP). Tạo và quản lý mã QR trực tiếp từ Claude, Cursor hoặc bất kỳ máy khách MCP nào. Được liệt kê trong Sổ đăng ký MCP chính thức. Máy khách hỗ trợ từ xa kết nối trực tiếp đến URL đó; máy khách chỉ dùng stdio có thể cầu nối đến nó với npx -y @open-qr/mcp và OPENQR_API_KEY được đặt (chi tiết).

Trình tạo tĩnh trong kho lưu trữ này không bao giờ gọi bất kỳ điều nào ở trên. Nó vẫn 100% phía máy khách (xem Quyền riêng tư) và không có điều nào trong số đó là bắt buộc để sử dụng hoặc tự lưu trữ trình tạo.

Kết nối máy khách MCP

Nhận khóa miễn phí tại openqr.uk/api, sau đó trỏ máy khách của bạn đến máy chủ với khóa làm tiêu đề xác thực.

Claude Code:

claude mcp add --transport http openqr https://openqr.uk/mcp \
  --header "Authorization: Bearer oqr_YOUR_KEY"

Cursor (~/.cursor/mcp.json) và bất kỳ máy khách nào khác hỗ trợ Streamable HTTP:

{
  "mcpServers": {
    "openqr": {
      "url": "https://openqr.uk/mcp",
      "headers": {
        "Authorization": "Bearer oqr_YOUR_KEY"
      }
    }
  }
}

Công cụ

Máy chủ MCP lưu trữ tại https://openqr.uk/mcp hiển thị các công cụ này (chạy tools/list để xem bộ công cụ trực tiếp). Mọi công cụ đều yêu cầu khóa API miễn phí — tạo một khóa tại openqr.uk/api và truyền nó dưới dạng Authorization: Bearer oqr_... trên kết nối MCP.

Công cụ	Chức năng
generate_qr	Tạo mã QR tĩnh từ bất kỳ văn bản hoặc URL nào. Trả về hình ảnh PNG hoặc đánh dấu SVG.
create_dynamic_qr	Tạo mã QR có thể chỉnh sửa mà bạn có thể thay đổi đích đến sau này mà không cần in lại.
update_dynamic_qr	Thay đổi đích đến, nhãn, liên kết ngắn tùy chỉnh, thẻ hoặc thư mục của mã động.
get_dynamic_qr	Lấy chi tiết đầy đủ của một mã: đích đến, liên kết ngắn, nhãn, loại, thẻ, thư mục, trạng thái, ngày tạo.
get_scans	Thống kê quét cho một mã động.
list_dynamic_qr	Liệt kê các mã động của bạn với id, URL ngắn, đích đến, nhãn và trạng thái.
delete_dynamic_qr	Xóa vĩnh viễn một mã động. Liên kết ngắn của nó ngừng hoạt động.
bulk_create_dynamic_qr	Tạo tối đa 200 mã động cùng lúc.
list_folders	Liệt kê các thư mục của bạn.
create_folder	Tạo một thư mục để tổ chức mã.
delete_folder	Xóa một thư mục. Các mã trong đó được bỏ phân loại, không bị xóa.
list_themes	Liệt kê các chủ đề kiểu đã lưu. Áp dụng một chủ đề bằng cách truyền id hoặc tên của nó dưới dạng theme.
create_theme	Lưu một chủ đề kiểu tái sử dụng (màu sắc, kiểu chấm và góc).
delete_theme	Xóa một chủ đề đã lưu. Các mã đã được tạo kiểu với nó vẫn giữ nguyên giao diện.
get_subdomain	Hiển thị tên miền phụ có thương hiệu trên tài khoản và liệu nó có bị đình chỉ hay không.
set_subdomain	Yêu cầu hoặc thay đổi tên miền phụ có thương hiệu để mã cũng phân giải tại {name}.oqr.to. Chỉ dành cho Pro.
clear_subdomain	Giải phóng tên miền phụ có thương hiệu. Các mã vẫn hoạt động trên liên kết ngắn thông thường.

Nó cũng hiển thị 5 tài nguyên và 4 lời nhắc:

• Tài nguyên là các cài đặt trước kiểu QR tích hợp tại openqr://preset/classic, /teal, /high-contrast, /dots và /classy. Đọc một tài nguyên và truyền kiểu của nó cho create_theme.
• Lời nhắc là create_tracked_qr, bulk_qr_for_print, brand_a_qr và qr_scan_report.

Tính năng

• Không hình mờ, không giới hạn kích thước, không đăng ký — mọi tính năng đều miễn phí
• Riêng tư theo thiết kế — mã được tạo hoàn toàn trong trình duyệt của bạn; nội dung không bao giờ chạm đến máy chủ
• Xuất ở mọi nơi — PNG / WebP lên đến 4096px, cộng với SVG và PDF vector thực
• Tạo kiểu đầy đủ — màu sắc, gradient, kiểu chấm & góc, nhúng logo, khung "Scan me"
• Nhập thông minh — dán liên kết hoặc văn bản và loại được tự động phát hiện
• Tải trọng phong phú — URL, văn bản, email, điện thoại, SMS, WhatsApp, Wi-Fi và trình chọn vị trí dựa trên bản đồ
• Sao chép một cú nhấp chuột, liên kết thiết kế có thể chia sẻ, chế độ sáng/tối, phản hồi, hỗ trợ bàn phím

Bắt đầu nhanh

pnpm install
pnpm dev        # http://localhost:3011

Xây dựng & tự lưu trữ

pnpm build
pnpm start      # serves on :3011 (standalone output)

Đây là ứng dụng Next.js tiêu chuẩn — lưu trữ ở bất kỳ đâu (VPS, Raspberry Pi, Cloudflare, sau bất kỳ proxy ngược nào). Nó không cần biến môi trường, không cần cơ sở dữ liệu, không cần bí mật để chạy. Các tập lệnh dev/start ở trên sử dụng cổng 3011; hình ảnh Docker bên dưới phục vụ trên 3000. Cấu hình duy nhất trong cả hai trường hợp là PORT.

Triển khai (Hình ảnh Docker)

Hình ảnh đa kiến trúc (linux/amd64, linux/arm64) được xuất bản lên GHCR trên mỗi thẻ phát hành:

docker run -d --name openqr --restart unless-stopped -p 3000:3000 ghcr.io/open-qr/openqr:latest

Hoặc với docker-compose.yml:

docker compose up -d          # update later: docker compose pull && docker compose up -d

Ghim thẻ phiên bản trong sản xuất (ghcr.io/open-qr/openqr:1.0.1); latest di chuyển theo mỗi bản phát hành. Container là một máy chủ độc lập, không phải root, được dựng sẵn với kiểm tra sức khỏe và mang LICENSE và NOTICE bên trong hình ảnh.

Triển khai một cú nhấp chuột

Máy chủ	Liên kết	Ghi chú
DigitalOcean App Platform	Nút 1 cú nhấp chuột	Đọc .do/deploy.template.yaml; phiên bản nhỏ nhất, cổng 3000
Render	Nút Blueprint	Đọc render.yaml; giả định phiên bản trả phí (gói miễn phí của Render ngủ)
Koyeb	Triển khai từ hình ảnh	Bất kỳ thẻ ghcr.io/open-qr/openqr công khai nào, không cần xây dựng kho

Triển khai qua bất kỳ tùy chọn nào trong số này không thêm điều khoản nào ngoài AGPL-3.0: nguồn là kho lưu trữ này và hình ảnh mang giấy phép và thông báo bên thứ ba.

Nhúng

Thành phần <Generator/> là độc lập và có thể cấu hình:

import { Generator } from "@/components/generator/generator";

// Full page (default OpenQR logo header):
<Generator />

// Embedded widget, your own branding, no default header:
<Generator embedded header={<MyLogo />} />

// Inject your own post-download call-to-action:
<Generator renderSuccess={(variant) => <MySupportCluster variant={variant} />} />

Công cụ đi kèm không phân tích dữ liệu. Nếu bạn muốn sự kiện UI ẩn danh (ví dụ: định dạng xuất nào được sử dụng — không bao giờ là nội dung QR), hãy chèn một trình xử lý:

import { setTrackHandler } from "@/lib/analytics";
setTrackHandler((action, name, category) => myAnalytics.track(category, action, name));

Quyền riêng tư

Việc tạo QR diễn ra 100% trong trình duyệt của bạn. Các cuộc gọi ra ngoài tùy chọn duy nhất là trong công cụ Vị trí: các ô bản đồ từ CARTO và tra cứu địa chỉ qua OpenStreetMap's Nominatim. Không có gì khác rời khỏi thiết bị.

Ngăn xếp công nghệ

Next.js 16 (App Router) · React 19 · TypeScript (nghiêm ngặt) · Tailwind v4 · qr-code-styling · Leaflet · pnpm.

Đóng góp

Xem CONTRIBUTING.md. Giữ nó đơn giản, dễ truy cập, phía máy khách và miễn phí — không tính năng nào nên yêu cầu thanh toán để xóa hình mờ hoặc mở khóa một định dạng.

Giấy phép

AGPL-3.0 © 2026 Sam Moreton.

Bạn được tự do sử dụng, nghiên cứu, sửa đổi, tự lưu trữ và phân phối lại OpenQR theo AGPL-3.0. Nếu bạn chạy một phiên bản đã sửa đổi như một dịch vụ mạng, AGPL yêu cầu bạn cung cấp mã nguồn của mình theo cùng giấy phép. Nếu điều đó không phù hợp với trường hợp sử dụng của bạn, giấy phép thương mại có sẵn — xem NOTICE.