# ຕິດຕັ້ງ OnlyOffice Document Server / Installing OnlyOffice Document Server

ເພື່ອແກ້ໄຂ Word / Excel / PowerPoint ໃນເວັບ (ຄັງໄຟລ໌ → ປຸ່ມ "ແກ້ໄຂໃນເວັບ").
To edit Word / Excel / PowerPoint in the browser (File library → "Edit online").

## 1. ຕິດຕັ້ງດ້ວຍ Docker (ແນະນຳ / recommended)

ເຄື່ອງແມ່ຂ່າຍ Linux, RAM ≥ 4 GB:

```bash
docker run -d --name onlyoffice --restart=always \
  -p 8080:80 \
  -e JWT_ENABLED=true \
  -e JWT_SECRET=ໃສ່ລະຫັດລັບຍາວໆຂອງທ່ານ \
  onlyoffice/documentserver
```

ເປີດ `http://SERVER-IP:8080` — ເຫັນໜ້າຕ້ອນຮັບ = ພ້ອມແລ້ວ.
ແນະນຳໃຫ້ວາງ reverse proxy + HTTPS ຕໍ່ໜ້າ (nginx/apache) ສຳລັບການໃຊ້ງານຈິງ.

## 2. ຕັ້ງຄ່າໃນ 7D Project Hub

1. ຕັ້ງຄ່າ → ທົ່ວໄປ → **App URL**: ທີ່ຢູ່ຂອງລະບົບນີ້ ທີ່ເຄື່ອງ OnlyOffice
   ເອື້ອມເຖິງໄດ້ (ເຊັ່ນ `https://hub.company.la` — ບໍ່ແມ່ນ localhost,
   ເວັ້ນແຕ່ທັງສອງຢູ່ເຄື່ອງດຽວກັນ).
2. ຕັ້ງຄ່າ → ຄັງໄຟລ໌ → **OnlyOffice**:
   - Document Server URL: `http://SERVER-IP:8080` (ຫຼື https ຂອງທ່ານ)
   - JWT Secret: ຄ່າດຽວກັບ `JWT_SECRET` ຂ້າງເທິງ
3. ເປີດຄັງໄຟລ໌ → ເລືອກໄຟລ໌ .docx/.xlsx/.pptx → ປຸ່ມ **📝 ແກ້ໄຂໃນເວັບ**.

## 3. ວິທີເຮັດວຽກ / How it works

- ກົດບັນທຶກ (ຫຼື ປິດ editor ຫຼັງແກ້) → Document Server ສົ່ງໄຟລ໌ໃໝ່ກັບມາ →
  ລະບົບເກັບຂອງເກົ່າໄວ້ເປັນ **ເວີຊັນ** (ຍ້ອນກັບໄດ້ໃນແຜງລາຍລະອຽດ) ແລະ
  ບັນທຶກໃສ່ປະຫວັດວ່າໃຜແກ້.
- ສິດ view ເປີດອ່ານໄດ້ຢ່າງດຽວ · ເຈົ້າຂອງ/ສິດ edit ແກ້ໄດ້.
- ແທຮກຮູບລາຍເຊັນ/ຕາປະທັບ: ໃນ editor ເມນູ **ແທຮກ → ຮູບພາບ** ແລ້ວເລືອກ
  ຮູບລາຍເຊັນທີ່ທ່ານດາວໂຫຼດຈາກຕູ້ນິລະໄພ.
- ບໍ່ຕັ້ງຄ່າ = ປຸ່ມບໍ່ສະແດງ ລະບົບອື່ນໃຊ້ໄດ້ປົກກະຕິ.

## ແກ້ບັນຫາ / Troubleshooting

| ອາການ | ສາເຫດ |
|---|---|
| ໜ້າ editor ຂຶ້ນ "ຕິດຕໍ່ Document Server ບໍ່ໄດ້" | URL ຜິດ ຫຼື ເຄື່ອງ DS ປິດຢູ່ / firewall |
| ເປີດເອກະສານຄ້າງ "Download failed" | DS ເອື້ອມ App URL ບໍ່ໄດ້ — ກວດ App URL + firewall |
| ບັນທຶກແລ້ວເວີຊັນບໍ່ຂຶ້ນ | JWT Secret ສອງຝັ່ງບໍ່ກົງກັນ |
