# gitroomhq/postiz-app: quản lý lịch đăng mạng xã hội — hướng dẫn cài đặt và dùng

> gitroomhq/postiz-app là nền tảng quản lý mạng xã hội mã nguồn mở, hỗ trợ lên lịch, đăng chéo, cộng tác, phân tích và tự động hóa qua API. Bạn có thể dùng Postiz Cloud hoặc tự triển khai bản open-source bằng Docker trên hạ tầng riêng. Cài bản self-hosted cần chuẩn bị PostgreSQL, Redis, storage và các biến môi trường nên phù hợp hơn với người có kỹ thuật.

- Tác giả: Ông T (https://ongt.vn/gioi-thieu)
- Chủ đề: Repo & Skill
- Đăng: 2026-10-07 · Cập nhật: 2026-11-13
- URL: https://ongt.vn/bai-viet/gitroomhq-postiz-app-quan-ly-lich-dang-mang-xa-hoi

gitroomhq/postiz-app là một nền tảng quản lý mạng xã hội để lên lịch, tự động hóa và phân tích nội dung. Repo này cung cấp bản Postiz mã nguồn mở, có thể tự triển khai trên máy chủ riêng thay vì phụ thuộc hoàn toàn vào dịch vụ lưu trữ của nhà cung cấp.

Postiz phù hợp với chủ shop, đội marketing, nhân viên phụ trách nội dung và lập trình viên cần quản lý nhiều kênh từ một nơi. Điểm đáng giá nhất là hệ thống kết hợp lịch đăng, đăng chéo, cộng tác nhóm, phân tích, API và các bề mặt agent như MCP, CLI cùng connector cho nhiều công cụ AI.

Repo hiện có khoảng 41496 sao và 7917 fork. Mã nguồn chính dùng TypeScript, giấy phép AGPL-3.0. Bạn có thể chọn Postiz Cloud để giảm công việc vận hành, hoặc dùng bản self-hosted để tự giữ dữ liệu, tự quản lý hạ tầng và tùy chỉnh mã nguồn.

```repo
- repo | gitroomhq/postiz-app
- kind | Ứng dụng
- desc | Postiz là nền tảng mã nguồn mở để lên lịch, tự động hóa và phân tích nội dung trên nhiều mạng xã hội.
- stars | 41k
- lang | TypeScript
- license | AGPL-3.0
```

## Postiz làm được gì

### Lên lịch và đăng nội dung lên nhiều kênh

Bạn có thể soạn nội dung rồi đặt lịch đăng lên các nền tảng xã hội được Postiz hỗ trợ. Lịch nội dung giúp đội marketing nhìn trước kế hoạch, giảm việc đăng thủ công từng kênh và hạn chế bỏ sót bài.

Postiz cũng hỗ trợ cross-posting, tức là đưa cùng một nội dung lên nhiều kênh. Tính năng này hữu ích khi một cửa hàng muốn giới thiệu sản phẩm đồng thời trên nhiều nền tảng, nhưng vẫn cần kiểm tra lại nội dung phù hợp với từng kênh trước khi đăng.

### Quản lý lịch, bài lặp và thời gian đăng

Hệ thống có chế độ xem lịch, bài đăng lặp lại, độ trễ giữa các bài và các bộ nội dung. Đây là nền tảng tốt cho những công việc có tính định kỳ như nhắc chương trình hàng tuần, đăng nội dung theo chuỗi hoặc duy trì lịch xuất bản ổn định.

### Phân tích hiệu quả nội dung

Postiz có analytics để đo lường công việc đã thực hiện. Bản self-hosted cần bạn tự cung cấp thông tin ứng dụng và quyền analytics phù hợp với từng nền tảng. Vì vậy, phần phân tích không chỉ phụ thuộc vào Postiz mà còn phụ thuộc vào quyền mà các nền tảng xã hội cấp cho ứng dụng của bạn.

### Cộng tác với đội nhóm

Bạn có thể mời thành viên tham gia, cùng bình luận và lên lịch bài. Postiz cũng có các tính năng trao đổi hoặc mua bài, nhóm khách hàng, Internal Plugs và Global Plugs theo phần giới thiệu của dự án.

Trong thực tế, đội marketing có thể để một người soạn nội dung, người khác kiểm tra, rồi người phụ trách cuối cùng đặt lịch. Cách làm này giúp giảm việc gửi file qua lại và giữ lịch đăng trong cùng một hệ thống.

### Tự động hóa qua API và công cụ workflow

Postiz được thiết kế cho các quy trình tự động. Repo nêu rõ khả năng tích hợp với N8N, Make.com, Zapier, Public API và webhooks. Dự án cũng có NodeJS SDK, N8N custom node và Make.com integration.

Bạn có thể dùng những kết nối này để đưa nội dung từ một hệ thống khác vào Postiz, kích hoạt quy trình khi có sự kiện, hoặc xây dựng công cụ nội bộ cho đội bán hàng và marketing.

### Hỗ trợ AI và agent

Postiz có AI Copilot, tạo ảnh AI, tạo video AI, Smart Agent và AI video clipping. Với bản self-hosted, các tính năng AI cần key của OpenAI hoặc nhà cung cấp khác, tùy tính năng; bạn tự trả chi phí cho nhà cung cấp đó.

Repo cũng liệt kê MCP, CLI và các connector cho Claude, ChatGPT, Codex, OpenClaw và Cursor. Với bản tự triển khai, bạn trỏ MCP hoặc CLI vào instance Postiz của mình.

### Tự giữ dữ liệu và tùy chỉnh mã nguồn

Bản open-source chạy trên hạ tầng của bạn, dữ liệu không rời khỏi môi trường đó theo bảng so sánh trong README. Bạn cũng có toàn quyền truy cập mã nguồn, có thể fork và chỉnh sửa theo giấy phép AGPL-3.0.

Đổi lại, bạn phải tự chịu trách nhiệm về uptime, sao lưu, bản vá bảo mật, cập nhật image, migration và cấu hình các dịch vụ phụ trợ.

## Cần chuẩn bị gì

Tư liệu của repo nêu Node.js phiên bản 22.23.4 trong `package.json`. Đây là yêu cầu kỹ thuật rõ ràng nhất cần kiểm tra trước khi bắt đầu.

Repo dùng pnpm workspaces trong một monorepo. Tech stack gồm NextJS và React ở phía giao diện, NestJS ở phía backend, Prisma với PostgreSQL mặc định, Temporal và Resend cho thông báo email.

Nếu tự triển khai bản open-source, README cho biết bạn cần tự chuẩn bị và cấu hình PostgreSQL, Redis, storage cùng các biến môi trường. Tệp `.env.example` liệt kê các tên biến như `DATABASE_URL`, `REDIS_URL`, `JWT_SECRET`, `FRONTEND_URL`, `NEXT_PUBLIC_BACKEND_URL`, `BACKEND_INTERNAL_URL`, `STORAGE_PROVIDER` và các biến Cloudflare R2.

Nếu muốn kết nối mạng xã hội, bạn cần tạo developer app và trải qua quy trình phê duyệt của từng nền tảng. README nêu các biến cho X, LinkedIn, Reddit và Apple; danh sách biến môi trường còn có các trường liên quan đến Cloudflare. Với Meta, YouTube và TikTok, README cảnh báo quá trình phê duyệt có thể mất nhiều thời gian.

Nếu dùng tính năng AI trong bản self-hosted, bạn cần tự cung cấp key của OpenAI hoặc nhà cung cấp AI khác. README không đưa ra danh sách đầy đủ tên biến key trong phần tư liệu được cung cấp, nên không nên tự đoán tên biến.

Bạn có thể triển khai bằng Docker, Coolify, Railway hoặc VPS bất kỳ theo README. Repo có `Dockerfile.dev`, `docker-compose.yaml`, `docker-compose.dev.yaml` và `railway.toml`, nhưng phần hướng dẫn chi tiết được README dẫn sang Quick Start Guide.

## Cài đặt từng bước

```steps
- Lấy mã nguồn | Tải repo về máy và mở terminal trong thư mục dự án
- Kiểm tra Node.js | Đảm bảo máy dùng Node.js 22.23.4 theo package.json
- Đọc hướng dẫn chính thức | Mở Quick Start Guide để làm theo quy trình triển khai
- Cấu hình dịch vụ | Chuẩn bị PostgreSQL, Redis, storage và các biến môi trường cần thiết
- Chọn cách triển khai | Dùng Docker, Coolify, Railway hoặc VPS theo hạ tầng của bạn
```

### Lấy mã nguồn về máy

Mở PowerShell hoặc terminal tại thư mục bạn muốn lưu dự án. Lệnh dưới đây là lệnh phổ thông để lấy repo về máy; lệnh `cd` đưa terminal vào đúng thư mục dự án.

```bash
git clone https://github.com/gitroomhq/postiz-app.git
cd postiz-app
```

Sau khi chạy xong, bạn sẽ thấy các tệp như `package.json`, `pnpm-lock.yaml`, `pnpm-workspace.yaml`, thư mục `apps/` và `libraries/`. Người mới thường vấp ở chỗ mở terminal sai thư mục hoặc gõ sai tên thư mục sau khi clone. Hãy kiểm tra rằng prompt terminal đang đứng trong thư mục `postiz-app` trước khi làm tiếp.

### Kiểm tra phiên bản Node.js

Mở `package.json` và kiểm tra yêu cầu Node.js là `22.23.4`. Bạn cũng có thể kiểm tra phiên bản đang có trên máy bằng lệnh phổ thông sau:

```bash
node --version
```

Nếu phiên bản không phải `22.23.4`, hãy cài hoặc chuyển sang đúng phiên bản trước khi tiếp tục. Tư liệu được cung cấp không nêu lệnh cài pnpm, lệnh cài dependency hay lệnh khởi động cụ thể, vì vậy mình không thêm các lệnh đó để tránh làm bạn chạy sai.

### Đọc Quick Start Guide

README chỉ dẫn người dùng làm theo Quick Start Guide để đưa dự án lên. README không chép trực tiếp các lệnh cài đặt và khởi động trong nội dung được cung cấp. Vì vậy, sau khi clone repo, bạn cần mở tài liệu Quick Start Guide được README tham chiếu và làm đúng phần dành cho phương thức triển khai bạn chọn.

Điểm này quan trọng với người mới: đừng tự đổi tên biến môi trường, tự đoán lệnh migration hoặc tự tạo tài khoản dịch vụ khi tài liệu chưa yêu cầu. Repo có `package.json` để khai báo cách chạy và có các file Docker Compose để phục vụ triển khai, nhưng tên lệnh cụ thể phải lấy từ tài liệu của chính dự án.

### Chuẩn bị biến môi trường

Repo có tệp `.env.example`. Hãy dùng tệp này làm danh sách kiểm tra cấu hình. Các tên biến được tư liệu nêu gồm:

```text
DATABASE_URL
REDIS_URL
JWT_SECRET
FRONTEND_URL
NEXT_PUBLIC_BACKEND_URL
BACKEND_INTERNAL_URL
CLOUDFLARE_ACCOUNT_ID
CLOUDFLARE_ACCESS_KEY
CLOUDFLARE_SECRET_ACCESS_KEY
CLOUDFLARE_BUCKETNAME
CLOUDFLARE_BUCKET_URL
CLOUDFLARE_REGION
STORAGE_PROVIDER
APPLE_BUNDLE_ID
APPLE_SERVICE_ID
APPLE_TEAM_ID
APPLE_KEY_ID
APPLE_PRIVATE_KEY
X_URL
X_API_KEY
X_API_SECRET
LINKEDIN_CLIENT_ID
LINKEDIN_CLIENT_SECRET
REDDIT_CLIENT_ID
REDDIT_CLIENT_SECRET
```

Bạn phải điền giá trị thật theo hạ tầng và các nền tảng muốn kết nối. Không đưa secret vào mã nguồn, không gửi file môi trường lên nơi công khai và không dán key vào cuộc trò chuyện hoặc issue. Với bản self-hosted, dữ liệu và key nằm trong môi trường bạn quản lý, nhưng việc bảo vệ máy chủ vẫn là trách nhiệm của bạn.

### Chọn phương án triển khai

README phân biệt Postiz Cloud và Postiz Open-source. Cloud có trải nghiệm được quản lý, kết nối các kênh trong vài phút và có ứng dụng mạng xã hội được phê duyệt sẵn. Bản open-source cho phép triển khai bằng Docker, Coolify, Railway hoặc VPS, nhưng bạn phải tự quản lý Postgres, Redis, storage, biến môi trường và các ứng dụng developer.

Nếu chọn Docker, hãy xem các file `Dockerfile.dev`, `docker-compose.yaml` và `docker-compose.dev.yaml` cùng Quick Start Guide. Nếu chọn Railway, repo có `railway.toml`. Tư liệu được cung cấp chưa ghi lệnh Docker, lệnh Railway hay lệnh khởi động cụ thể, nên hãy dùng đúng lệnh trong hướng dẫn của dự án.

## Kiểm tra đã chạy được chưa

Cách kiểm tra phụ thuộc vào phương án triển khai. README cho biết mục tiêu là đưa dự án lên theo Quick Start Guide, nhưng phần tư liệu được cung cấp không ghi URL local, cổng mặc định, lệnh start hoặc màn hình kết quả cụ thể.

Một lần triển khai được xem là đi đúng hướng khi bạn hoàn thành cấu hình PostgreSQL, Redis, storage và các biến môi trường mà Quick Start Guide yêu cầu, sau đó mở được giao diện Postiz theo địa chỉ do phương án triển khai cung cấp. Bạn cũng nên thử đăng nhập, kết nối một kênh xã hội và tạo một bài nháp trước khi đặt lịch thật.

Nếu cần analytics, hãy kiểm tra riêng quyền analytics của developer app. Nếu cần AI, hãy kiểm tra key của nhà cung cấp AI và cấu hình mà tài liệu yêu cầu. Nếu cần API hoặc webhook, hãy thử một quy trình nhỏ trước khi kết nối với hệ thống sản xuất.

## Dùng vào việc thật

### Chủ shop lập lịch nội dung cho cả tuần

Một chủ shop có thể chuẩn bị trước các bài giới thiệu sản phẩm, mẹo sử dụng và chương trình khuyến mại. Trong Postiz, bạn soạn nội dung, chọn các kênh cần đăng, xem lịch và đặt thời điểm xuất bản. Cross-posting giúp giảm việc sao chép thủ công, còn chế độ xem lịch giúp nhìn toàn bộ tuần.

Kết quả mong đợi là các bài được gom trong một lịch chung thay vì nằm rải rác ở nhiều ứng dụng. Trước khi đăng, bạn vẫn nên chỉnh câu chữ, hình ảnh và lời kêu gọi hành động cho phù hợp từng nền tảng.

### Nhân viên văn phòng phối hợp duyệt nội dung

Một người phụ trách nội dung có thể tạo bài, mời đồng nghiệp vào nhóm, nhận bình luận và điều chỉnh lịch đăng. Người quản lý kiểm tra nội dung trong cùng hệ thống trước khi bài được xuất bản.

Cách này phù hợp với đội nhỏ chưa cần quy trình phức tạp. Quyền truy cập và quy trình phê duyệt cụ thể cần làm theo khả năng mà instance đã triển khai cung cấp; README chỉ xác nhận việc mời thành viên, cộng tác, bình luận và lên lịch.

### Dev tự động đưa nội dung từ hệ thống khác vào lịch đăng

Một lập trình viên có thể kết nối Postiz với N8N, Make.com, Zapier, Public API hoặc webhooks. Ví dụ, một bài đã được duyệt trong hệ thống nội bộ có thể kích hoạt workflow để đưa nội dung vào Postiz, sau đó đội marketing kiểm tra trước khi đặt lịch.

README cũng nêu NodeJS SDK và các tích hợp liên quan. Tuy nhiên, phần tư liệu được cung cấp không có endpoint, schema request hoặc ví dụ code API cụ thể, nên bạn cần xem tài liệu API trước khi viết tích hợp thật.

### Đội marketing đo lường và cải thiện lịch đăng

Sau khi kết nối các kênh có quyền analytics, đội marketing có thể xem kết quả và đánh giá công việc đã thực hiện. Từ dữ liệu đó, bạn có thể điều chỉnh chủ đề, tần suất hoặc thời điểm đăng.

Bản self-hosted yêu cầu app credential có analytics scopes. Nếu nền tảng không cấp quyền phù hợp, phần phân tích có thể không đầy đủ dù Postiz đã được cài thành công.

> Tự động hóa tốt không bắt đầu từ việc đăng thật nhiều, mà từ một lịch nội dung có thể kiểm tra và đo lường.
>
> — Ông T

## Lỗi hay gặp và cách xử lý

### Node.js không đúng phiên bản

`package.json` yêu cầu Node.js 22.23.4. Nếu máy dùng phiên bản khác, dependency hoặc tiến trình chạy có thể không tương thích. Hãy kiểm tra bằng `node --version`, sau đó chuyển về đúng phiên bản trước khi làm tiếp.

### Thiếu PostgreSQL, Redis hoặc storage

Bản self-hosted không chỉ là tải mã nguồn rồi mở giao diện. README yêu cầu bạn tự cấu hình Postgres, Redis, storage và các biến môi trường. Kiểm tra lại `DATABASE_URL`, `REDIS_URL`, `STORAGE_PROVIDER` và các giá trị storage theo Quick Start Guide.

### Kết nối mạng xã hội bị từ chối

Bản open-source yêu cầu bạn tự tạo developer app và đi qua quy trình phê duyệt của từng nền tảng. Meta, YouTube và TikTok có thể cần thời gian phê duyệt đáng kể. Nếu OAuth hoặc analytics chưa hoạt động, kiểm tra lại app credential, redirect configuration và quyền đã được cấp theo tài liệu của nền tảng.

### Tính năng AI không hoạt động

Bản self-hosted không dùng quota AI do Postiz quản lý. Bạn cần tự mang key OpenAI hoặc nhà cung cấp khác và chịu chi phí của họ. Kiểm tra đúng tên biến trong tài liệu, không tự đoán tên biến chỉ từ tên tính năng.

### Cập nhật làm phát sinh việc vận hành

Với Cloud, nhà cung cấp đảm nhiệm cập nhật và zero downtime. Với self-hosted, bạn phải tự kéo image mới, chạy migration, sao lưu và xử lý bản vá bảo mật. Hãy sao lưu dữ liệu và đọc hướng dẫn cập nhật trước khi thay đổi một hệ thống đang phục vụ lịch đăng thật.

```note
Không đưa DATABASE_URL, JWT_SECRET, API key, private key hoặc access token vào repo công khai. Bản self-hosted giữ dữ liệu trong hạ tầng của bạn, nhưng bảo mật máy chủ, sao lưu và quyền truy cập vẫn do bạn chịu trách nhiệm.
```

## Có nên dùng không

Postiz đáng cân nhắc nếu bạn cần quản lý nhiều mạng xã hội, muốn có lịch đăng tập trung, cần cộng tác nhóm hoặc muốn nối quy trình với N8N, Make.com, Zapier và API. Repo có hệ sinh thái khá rộng: NextJS, NestJS, Prisma, PostgreSQL, Redis, Temporal, Resend, MCP, CLI và nhiều connector cho agent.

Bản open-source đặc biệt phù hợp với doanh nghiệp muốn tự giữ dữ liệu, cần triển khai trong vùng hạ tầng riêng hoặc muốn sửa mã nguồn. Giấy phép AGPL-3.0 cho phép tiếp cận và tùy chỉnh mã nguồn theo điều kiện của giấy phép.

Giới hạn lớn nhất là công việc vận hành. Bạn phải tự chuẩn bị server, Postgres, Redis, storage, biến môi trường, developer app, quyền OAuth, sao lưu, cập nhật và bảo mật. Những nền tảng yêu cầu phê duyệt có thể làm thời gian triển khai kéo dài. Tư liệu được cung cấp cũng chưa ghi đầy đủ lệnh cài dependency và lệnh khởi động, nên người mới cần bám Quick Start Guide.

Nếu bạn chỉ cần lên lịch nhanh, không muốn quản trị máy chủ và không cần tự giữ toàn bộ hạ tầng, Postiz Cloud sẽ dễ bắt đầu hơn. Nếu bạn cần quyền kiểm soát dữ liệu, số lượng kênh và bài đăng không bị giới hạn theo gói, hoặc muốn tích hợp sâu với hệ thống nội bộ, bản self-hosted là lựa chọn hợp lý hơn.

## Câu hỏi thường gặp

### Postiz có miễn phí không?

Bản open-source miễn phí theo giấy phép AGPL-3.0, nhưng bạn phải tự trả chi phí hạ tầng như máy chủ, PostgreSQL, Redis, storage và các dịch vụ liên quan. Postiz Cloud tính phí theo gói và README nêu có thời gian dùng thử 7 ngày.

### Postiz có chạy được trên Windows không?

Tư liệu được cung cấp không xác nhận hệ điều hành cụ thể cho bản tự triển khai. Repo nêu các phương án Docker, Coolify, Railway và VPS, cùng yêu cầu Node.js 22.23.4; bạn nên xem Quick Start Guide để biết môi trường được hỗ trợ.

### Có cần GPU để chạy Postiz không?

Tư liệu không nói Postiz yêu cầu GPU. Các tính năng AI trong bản self-hosted cần key của OpenAI hoặc nhà cung cấp khác và có thể cần cấu hình bổ sung, nhưng repo không nêu yêu cầu phần cứng GPU.

### Dữ liệu của bản self-hosted có an toàn hơn không?

README cho biết bản self-hosted chạy trên máy chủ của bạn và dữ liệu không rời khỏi môi trường đó. Tuy vậy, bảo mật máy chủ, sao lưu, quyền truy cập, bản vá và bảo vệ key đều do bạn chịu trách nhiệm.

### Bản self-hosted có bị giới hạn số kênh hoặc số bài đăng không?

Theo bảng so sánh trong README, bản open-source có kênh, bài đăng và thành viên không giới hạn. Bạn vẫn phải tự đáp ứng giới hạn hoặc quy trình phê duyệt của từng nền tảng xã hội.

### Postiz khác gì một công cụ lên lịch mạng xã hội thông thường?

Ngoài lên lịch và đăng chéo, Postiz có cộng tác nhóm, bình luận, analytics, API, webhooks, tích hợp workflow, MCP, CLI và các connector cho agent. Bản open-source còn cho phép bạn tự triển khai và sửa mã nguồn theo AGPL-3.0.

### Có cần tự tạo ứng dụng trên từng mạng xã hội không?

Có, nếu bạn dùng bản open-source. README cho biết bạn phải tự tạo developer app và trải qua phê duyệt của các nền tảng; Postiz Cloud có các ứng dụng được phê duyệt sẵn cho những kênh được hỗ trợ.
