# postiz-app: Lên lịch mạng xã hội tự động — hướng dẫn cài đặt và dùng

> Postiz là nền tảng quản lý mạng xã hội giúp lên lịch, tự động hóa, phân tích và cộng tác khi xuất bản nội dung. Bạn có thể dùng Postiz Cloud hoặc tự triển khai bản mã nguồn mở, nhưng bản self-hosted cần tự chuẩn bị máy chủ, PostgreSQL, Redis, lưu trữ và thông tin xác thực của từng nền tảng.

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

Postiz là 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 `gitroomhq/postiz-app` chứa bản mã nguồn mở, có thể tự triển khai trên hạ tầng của bạn. Dự án viết chủ yếu bằng TypeScript, dùng giấy phép AGPL-3.0 và hiện có khoảng 41.496 sao cùng 7.917 fork.

Công cụ này hợp với chủ shop, nhóm marketing, nhân viên văn phòng quản lý nhiều kênh và lập trình viên muốn kết nối quy trình nội dung với API, N8N, Make.com, Zapier hoặc các agent AI. Điểm đáng giá nhất là bạn có thể gom lịch đăng, cộng tác nhóm, phân tích và các kết nối tự động vào một nơi. Nếu tự vận hành, dữ liệu chạy trên hạ tầng của bạn và bạn có quyền sửa mã nguồn theo điều kiện của AGPL-3.0.

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

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

Postiz tập trung vào quy trình xuất bản nội dung trên nhiều mạng xã hội. Bạn có thể dùng bản Cloud được quản lý sẵn hoặc triển khai bản open-source trên máy chủ riêng. Hai lựa chọn có cùng các tính năng cốt lõi, nhưng khác nhau ở hạ tầng, việc tạo ứng dụng dành cho nhà phát triển và trách nhiệm bảo trì.

- **Lên lịch bài đăng trên nhiều kênh:** Bạn tạo nội dung và đặt thời điểm xuất bản thay vì phải đăng thủ công từng nơi. Điều này phù hợp với cửa hàng cần duy trì lịch nội dung đều đặn hoặc nhóm marketing làm việc theo kế hoạch tuần, tháng.

- **Lịch nội dung và đăng chéo:** Các chế độ xem lịch giúp cả nhóm biết bài nào sắp đăng. Tính năng cross-posting hỗ trợ đưa cùng một nội dung lên nhiều kênh, giảm thao tác lặp lại.

- **Bài đăng lặp lại, bộ nội dung và chữ ký:** Bạn có thể tổ chức các nội dung dùng lại, thiết lập bài đăng lặp lại và thêm chữ ký theo quy trình của đội. Đây là cách hữu ích để duy trì các nội dung định kỳ mà không phải tạo lại từ đầu.

- **Bình luận và độ trễ giữa các bài:** Thành viên có thể trao đổi ngay trong quy trình nội dung. Các khoảng trễ giữa bài đăng giúp lịch xuất bản được sắp xếp có chủ đích hơn.

- **Phân tích hiệu quả:** Postiz có khu vực analytics để đo lường công việc nội dung. Với bản self-hosted, phần analytics cần thông tin xác thực ứng dụng riêng và các quyền analytics phù hợp từ nền tảng mạng xã hội.

- **Cộng tác theo nhóm:** Bạn có thể mời thành viên, phân công trao đổi, bình luận và cùng lên lịch. Hệ thống cũng có customer groups, phù hợp với nhóm làm nội dung cho nhiều khách hàng hoặc nhiều thương hiệu.

- **Tự động hóa qua API và webhook:** Postiz được thiết kế cho các quy trình tự động. Bạn có thể kết nối với N8N, Make.com, Zapier, Public API và webhook để đưa nội dung từ hệ thống khác vào lịch đăng.

- **Kết nối với agent và công cụ phát triển:** Dự án cung cấp các bề mặt agentic như MCP, CLI và connector cho Claude, ChatGPT, Codex, OpenClaw và Cursor. Bạn có thể trỏ các công cụ này vào Postiz Cloud hoặc vào instance riêng của mình.

- **Tính năng AI:** Postiz có AI Copilot, tạo ảnh AI, tạo video AI, cắt video bằng AI và Smart Agent. Bản self-hosted cho phép dùng khóa API của nhà cung cấp AI của bạn; chi phí API do bạn trả cho nhà cung cấp.

- **RSS tự động đăng và Internal/Global Plugs:** Các nguồn RSS có thể được đưa vào luồng tự động đăng. Internal Plugs và Global Plugs hỗ trợ tổ chức nội dung dùng chung trong hệ thống.

- **Tích hợp và mở rộng:** Bạn có thể dùng NodeJS SDK, node tùy chỉnh cho N8N và tích hợp Make.com. Vì có mã nguồn đầy đủ, đội kỹ thuật cũng có thể sửa code hoặc thêm provider theo nhu cầu, miễn tuân thủ AGPL-3.0.

> Giá trị của Postiz nằm ở việc biến lịch nội dung, cộng tác nhóm và tự động hóa thành một quy trình thống nhất.
>
> — Ông T

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

Tư liệu cho biết package.json của dự án yêu cầu Node.js phiên bản **22.23.4**. Repo dùng Pnpm workspaces trong một monorepo, nên bạn cần có pnpm để làm việc với workspace. Công nghệ chính gồm NextJS, React, NestJS, Prisma, PostgreSQL mặc định, Temporal và Resend cho thông báo email.

Nếu tự triển khai, bạn cần chuẩn bị hạ tầng để chạy ứng dụng, cơ sở dữ liệu PostgreSQL, Redis và nơi lưu trữ tệp. Bản self-hosted cho phép triển khai bằng Docker, Coolify, Railway hoặc bất kỳ VPS nào phù hợp. Tư liệu không nêu cấu hình phần cứng tối thiểu.

Bạn cũng cần các biến môi trường được khai báo trong `.env.example`. Nhóm biến quan trọng gồm:

- `DATABASE_URL` cho cơ sở dữ liệu.
- `REDIS_URL` cho Redis.
- `JWT_SECRET` cho secret của phiên xác thực.
- `FRONTEND_URL`, `NEXT_PUBLIC_BACKEND_URL` và `BACKEND_INTERNAL_URL` cho các địa chỉ frontend, backend.
- Các biến Cloudflare R2 hoặc dịch vụ lưu trữ tương ứng như `CLOUDFLARE_ACCOUNT_ID`, `CLOUDFLARE_ACCESS_KEY`, `CLOUDFLARE_SECRET_ACCESS_KEY`, `CLOUDFLARE_BUCKETNAME`, `CLOUDFLARE_BUCKET_URL`, `CLOUDFLARE_REGION` và `STORAGE_PROVIDER`.
- Thông tin Apple nếu cần kết nối Apple: `APPLE_BUNDLE_ID`, `APPLE_SERVICE_ID`, `APPLE_TEAM_ID`, `APPLE_KEY_ID` và `APPLE_PRIVATE_KEY`.
- Thông tin kết nối X: `X_URL`, `X_API_KEY` và `X_API_SECRET`.
- Thông tin LinkedIn: `LINKEDIN_CLIENT_ID` và `LINKEDIN_CLIENT_SECRET`.
- Thông tin Reddit: `REDDIT_CLIENT_ID` và `REDDIT_CLIENT_SECRET`.

Với mỗi mạng xã hội, bản self-hosted yêu cầu bạn tự tạo ứng dụng dành cho nhà phát triển và đi qua quy trình phê duyệt của nền tảng. Một số nền tảng như Meta, YouTube và TikTok có thể mất nhiều thời gian phê duyệt. Tư liệu không nói cần GPU, nên chưa thể kết luận rằng GPU là bắt buộc hoặc được hỗ trợ.

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

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

```steps
- Chuẩn bị mã nguồn | Lấy repo và mở terminal trong thư mục dự án
- Kiểm tra môi trường | Dùng Node.js 22.23.4 và pnpm workspaces
- Đọc cấu hình | Mở .env.example để biết các biến cần chuẩn bị
- Chọn cách triển khai | Dùng Docker, Coolify, Railway hoặc VPS theo Quick Start Guide
- Kết nối dịch vụ | Chuẩn bị PostgreSQL, Redis, storage và thông tin nền tảng
- Khởi chạy và kiểm tra | Làm theo lệnh trong package.json và xác nhận giao diện hoạt động
```

### Chuẩn bị mã nguồn

README cho biết cách chạy chi tiết nằm trong Quick Start Guide, nhưng phần nội dung được cung cấp không chứa các lệnh cài đặt cụ thể. Bạn có thể lấy mã nguồn bằng lệnh Git phổ thông dưới đây. Hãy mở PowerShell hoặc terminal tại thư mục mà bạn muốn lưu dự án.

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

Lệnh đầu tiên tải repo về máy. Lệnh thứ hai chuyển terminal vào thư mục dự án. Nếu dùng PowerShell, bạn vẫn có thể chạy hai lệnh này. Tên thư mục có thể được tạo từ tên repo, nên hãy kiểm tra terminal đang đứng đúng trong thư mục `postiz-app` trước khi thực hiện bước sau.

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

Repo yêu cầu Node.js 22.23.4. Bạn nên kiểm tra phiên bản trước khi cài các dependency. Tư liệu được cung cấp không nêu lệnh kiểm tra hoặc lệnh cài Node.js cụ thể, nên hãy dùng công cụ quản lý Node.js quen thuộc của hệ điều hành và đặt đúng phiên bản này.

```bash
node --version
```

Kết quả mong đợi là phiên bản tương ứng với `22.23.4`. Nếu phiên bản thấp hơn hoặc cao hơn, hãy đổi về phiên bản repo yêu cầu trước khi tiếp tục. Không nên bỏ qua yêu cầu này vì monorepo có thể dùng cú pháp hoặc dependency không tương thích với phiên bản Node khác.

### Đọc file cấu hình mẫu

Trong thư mục repo có `.env.example`. Hãy mở file này bằng trình soạn thảo mã nguồn để xem các biến cấu hình. Tư liệu chỉ cung cấp tên biến, chưa cung cấp giá trị mẫu hoặc lệnh sao chép thành file `.env`.

```bash
.env.example
```

Dòng trên chỉ là tên file để bạn mở trong trình soạn thảo, không phải một lệnh chạy độc lập trong terminal. Người mới thường nhầm cách này và nhận lỗi vì cố chạy tên file như chương trình. Bạn cần tạo cấu hình theo hướng dẫn Quick Start Guide của dự án, điền địa chỉ PostgreSQL, Redis, storage và các thông tin xác thực cần thiết.

### Cài dependency của monorepo

Dự án dùng Pnpm workspaces và có `pnpm-lock.yaml`, nhưng README được cung cấp không ghi lệnh cài dependency cụ thể. Vì vậy, không nên tự đoán thêm cờ lệnh hoặc tên package. Hãy mở `package.json` và Quick Start Guide để lấy đúng lệnh mà maintainer quy định.

```bash
pnpm --version
```

Lệnh trên chỉ kiểm tra pnpm có sẵn trong terminal. README không nói phiên bản pnpm cụ thể. Nếu terminal báo không tìm thấy lệnh, bạn cần cài pnpm theo cách phù hợp với máy của mình rồi quay lại làm theo hướng dẫn chính thức trong repo.

### Chọn cách triển khai

README nêu các lựa chọn Docker, Coolify, Railway hoặc VPS. Repo có `Dockerfile.dev`, `docker-compose.dev.yaml` và `docker-compose.yaml`, nhưng phần tư liệu được cung cấp không chứa lệnh Docker chính xác để khởi chạy. Bạn cần mở Quick Start Guide và các file compose để xác định file nào dành cho môi trường của mình.

Nếu chọn self-hosted, hãy chuẩn bị PostgreSQL, Redis, storage và các biến môi trường trước khi khởi động. Nếu chọn Postiz Cloud, bạn không cần tự quản lý các thành phần hạ tầng này, nhưng sẽ dùng mô hình thuê bao theo gói và có giới hạn theo gói.

### Kết nối mạng xã hội và AI

Sau khi ứng dụng chạy, hãy kết nối từng kênh theo quy trình xác thực của nền tảng. Bản self-hosted yêu cầu bạn tự tạo developer app và chờ phê duyệt nếu nền tảng yêu cầu. Với AI, bạn dùng khóa API của nhà cung cấp riêng nếu muốn bật AI Copilot, ảnh, video hoặc Smart Agent.

README không cung cấp câu lệnh CLI cụ thể, màn hình cài đặt chi tiết hay giá trị mẫu cho từng khóa. Vì vậy, bước này phải làm theo Quick Start Guide và giao diện thực tế của phiên bản repo bạn triển khai.

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

Dấu hiệu đầu tiên là Node.js trả về phiên bản `22.23.4`, pnpm có thể chạy và terminal không báo thiếu công cụ. Sau đó, các dependency phải được cài thành công theo lệnh trong `package.json` hoặc Quick Start Guide.

Khi triển khai bằng Docker, Coolify, Railway hoặc VPS, hãy kiểm tra container hoặc dịch vụ không bị dừng ngay sau khi khởi động. Ứng dụng cần kết nối được tới PostgreSQL, Redis và storage đã cấu hình. Nếu thiếu `DATABASE_URL`, `REDIS_URL`, `JWT_SECRET` hoặc URL frontend/backend, ứng dụng có thể không hoạt động đúng.

Ở mức sử dụng, kết quả mong đợi là bạn mở được giao diện Postiz, tạo hoặc đăng nhập tài khoản, kết nối một kênh mạng xã hội và tạo được một bài đăng có lịch. Nếu dùng analytics, cần thêm credential riêng với analytics scope. Nếu dùng API, webhook hoặc agent, hãy kiểm tra instance mà connector trỏ tới là đúng địa chỉ của bạn.

README không cung cấp ảnh màn hình hoặc một lệnh health check cụ thể. Khi cần xác nhận sâu hơn, hãy xem log của Docker hoặc nền tảng triển khai, rồi đối chiếu với cấu hình trong `.env.example` và hướng dẫn Quick Start Guide.

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

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

Một chủ shop bán hàng trên nhiều kênh 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 tạo từng bài, chọn thời điểm, dùng lịch để xem toàn bộ tuần và dùng cross-posting khi muốn đưa nội dung lên nhiều kênh.

Kết quả là chủ shop không cần nhớ đăng thủ công mỗi ngày. Các bài đăng lặp lại có thể dùng cho nội dung định kỳ, còn chữ ký giúp giữ cách nhận diện thống nhất giữa các bài.

### Nhân viên marketing phối hợp với đồng nghiệp

Một nhóm marketing có thể mời các thành viên vào workspace để cùng bình luận, chỉnh nội dung và lên lịch. Mỗi bài được trao đổi trong quy trình chung thay vì gửi qua nhiều cuộc trò chuyện riêng. Customer groups phù hợp khi nhóm đang quản lý nội dung cho nhiều thương hiệu hoặc khách hàng.

Kết quả là người phụ trách có thể nhìn lịch chung, biết bài nào đang chờ góp ý và giảm nguy cơ hai người đăng trùng một nội dung.

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

Một lập trình viên có thể kết nối Public API hoặc webhook với hệ thống nội bộ. Ví dụ, khi một nội dung được duyệt trong quy trình riêng, hệ thống gửi dữ liệu sang Postiz để tạo lịch đăng. N8N, Make.com và Zapier cũng nằm trong nhóm công cụ mà README nêu rõ là phù hợp cho tự động hóa.

Nếu đội dùng agent, họ có thể kết nối MCP, CLI hoặc connector tương ứng tới Postiz Cloud hay instance self-hosted. Cần kiểm tra kỹ endpoint để agent không gửi nội dung nhầm sang môi trường khác.

### Nhóm nội dung đo lường và cải thiện lịch đăng

Một nhóm marketing có thể dùng analytics để xem hiệu quả công việc nội dung, sau đó điều chỉnh lịch, nội dung lặp lại và cách đăng chéo. Với bản self-hosted, nhóm cần tự tạo developer app và cấp analytics scopes phù hợp cho các kênh liên quan.

Nếu muốn tự động hóa từ nguồn bên ngoài, nhóm có thể dùng RSS auto-post. Với AI Copilot hoặc Smart Agent, nhóm có thể mang khóa LLM riêng vào hệ thống; chi phí phát sinh do nhà cung cấp API tính, không phải do Postiz miễn phí bao gồm.

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

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

Nếu Node.js không phải `22.23.4`, dependency hoặc quá trình build có thể gặp lỗi. Hãy kiểm tra lại bằng `node --version`, đổi sang đúng phiên bản repo yêu cầu rồi chạy lại các bước trong Quick Start Guide.

### Thiếu biến môi trường

Lỗi kết nối database, Redis, frontend hoặc backend thường liên quan tới biến môi trường chưa có giá trị đúng. Đối chiếu với `.env.example`, đặc biệt là `DATABASE_URL`, `REDIS_URL`, `JWT_SECRET`, các URL dịch vụ và thông tin storage. Không chép secret vào mã nguồn hoặc gửi trong kênh công khai.

### Kết nối mạng xã hội chưa được phê duyệt

Bản self-hosted không tự cung cấp các ứng dụng đã được phê duyệt như bản Cloud. Bạn phải tự tạo developer app và có thể phải chờ nền tảng xét duyệt, nhất là với Meta, YouTube hoặc TikTok. Nếu OAuth hoặc đăng bài chưa hoạt động, hãy kiểm tra client ID, client secret, redirect URL theo hướng dẫn của nền tảng và Postiz.

### Analytics không trả dữ liệu

Analytics trong bản self-hosted cần credential riêng với analytics scopes. Nếu chỉ kết nối tài khoản nhưng không cấp đúng quyền, phần đo lường có thể không trả dữ liệu. Hãy kiểm tra lại quyền của developer app và cấu hình provider.

### Hạ tầng tự triển khai bị gián đoạn

Với bản self-hosted, bạn tự chịu trách nhiệm về uptime, backup, security patch, cập nhật image và migration. Khi dịch vụ dừng, hãy kiểm tra log ứng dụng, trạng thái PostgreSQL, Redis, storage và các biến môi trường trước khi thay đổi cấu hình. Không xóa dữ liệu hoặc chạy migration không rõ tác dụng khi chưa có bản sao lưu.

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

Postiz đáng dùng nếu bạn cần một trung tâm quản lý nội dung mạng xã hội có lịch, đăng chéo, cộng tác, phân tích và tự động hóa. Mã nguồn mở, số lượng kênh, bài đăng và thành viên trong bản self-hosted không bị giới hạn theo gói; bạn chỉ trả chi phí hạ tầng và các dịch vụ bên ngoài. Bạn cũng có thể sửa code, thêm provider và đưa hệ thống vào vùng dữ liệu hoặc môi trường air-gapped do mình chọn.

Giới hạn lớn nhất là bản self-hosted không phải kiểu cài xong là mọi kênh hoạt động ngay. Bạn phải tự quản lý PostgreSQL, Redis, storage, secret, backup, cập nhật, migration và bảo mật. Bạn cũng phải tự tạo ứng dụng dành cho nhà phát triển trên từng nền tảng, trong khi việc phê duyệt có thể kéo dài. Tư liệu hiện có chưa cung cấp đầy đủ lệnh cài đặt, cấu hình mẫu hay yêu cầu phần cứng.

Nếu bạn muốn bắt đầu nhanh, không muốn quản lý máy chủ hoặc cần các ứng dụng mạng xã hội đã được phê duyệt sẵn, Postiz Cloud phù hợp hơn. Cloud có thời gian dùng thử bảy ngày nhưng áp dụng giới hạn theo gói và mô hình thuê bao. Nếu dữ liệu cần nằm trong hạ tầng riêng, đội có người vận hành và muốn toàn quyền tùy biến, bản open-source là lựa chọn hợp lý. Hãy đọc Quick Start Guide và các file trong repo trước khi triển khai production.

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

### Postiz bản self-hosted có miễn phí không?

README ghi bản open-source self-hosted miễn phí vĩnh viễn theo giấy phép AGPL-3.0. Bạn vẫn phải tự trả chi phí máy chủ, PostgreSQL, Redis, storage và các API bên ngoài nếu có.

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

Tư liệu được cung cấp không nêu yêu cầu GPU. Vì vậy chưa thể khẳng định GPU là bắt buộc hoặc được hỗ trợ cho bản self-hosted.

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

Tư liệu không nêu hệ điều hành được hỗ trợ trực tiếp. Dự án có Docker và các lựa chọn triển khai như Coolify, Railway hoặc VPS, nhưng bạn cần xem Quick Start Guide để biết hướng dẫn phù hợp.

### Dữ liệu self-hosted có rời khỏi hạ tầng của tôi không?

README nói bản open-source 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 nhiên bạn tự chịu trách nhiệm về bảo mật, backup, quyền truy cập và các dịch vụ bên ngoài mà bạn kết nối.

### Bản self-hosted có dùng được mọi mạng xã hội ngay không?

Không nhất thiết. Bạn phải tự tạo developer app trên từng nền tảng và đi qua quy trình phê duyệt của họ; một số nền tảng có thể mất nhiều thời gian. Bản Cloud có các app đã được phê duyệt sẵn cho từng kênh.

### Có cần tự cung cấp khóa AI không?

Với bản self-hosted, các tính năng AI dùng khóa OpenAI hoặc nhà cung cấp khác do bạn mang vào. Bạn tự trả chi phí cho nhà cung cấp API; README không nêu hạn mức hay mức giá cụ thể.

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

Postiz kết hợp lịch đăng, đăng chéo, cộng tác, analytics, API, webhook, RSS auto-post và các kết nối agent trong một nền tảng. Tư liệu không cung cấp tên hoặc tính năng của một công cụ đối chiếu cụ thể nên chưa thể so sánh trực tiếp với sản phẩm X.
