# อัปเดตเวอร์ชันและย้ายจากปลั๊กอินในตัว

> อัปเดต Anasaki Studio อย่างปลอดภัย ล็อกเวอร์ชัน เพิ่มฐานข้อมูลของ Site Code ให้เว็บที่ติดตั้งก่อนหน้า และสิ่งที่เกิดขึ้นกับปลั๊กอินในตัวเดิมเมื่ออัปเกรดเป็น 2.0

ที่มา: https://anasaki.live/docs/studio/upgrade

## อัปเดตตามปกติ

1. สำรองข้อมูลก่อนเสมอ — [ส่งออก / นำเข้าเว็บ](/docs/studio/export-import) หรือสำรอง Docker volume
2. ในโฟลเดอร์ที่มี `docker-compose.yml` สั่ง:
    0 
3. เปิดหน้าจัดการ แล้วดูเลขที่ **ตั้งค่าเว็บไซต์ → ทั่วไป → เวอร์ชันระบบ**

ข้อมูลทั้งหมดอยู่ใน volume จึงไม่หายตอนอัปเดต ระบบปรับโครงสร้างฐานข้อมูลให้เองตอนเริ่มทำงาน

### ล็อกเวอร์ชัน

เว็บที่ใช้งานจริงควรล็อกเวอร์ชันแทน `latest` แล้วค่อยเลื่อนเลขเมื่อพร้อม:

```ini
STUDIO_IMAGE=chichat/anasaki-studio:2.0.5
```

แท็กที่มี: `X.Y.Z` (เช่น `2.0.5`), `X.Y` (`2.0` = แพตช์ล่าสุดของ 2.0), `X` และ `latest` — เวอร์ชันทดสอบ เช่น `2.1.0-rc.1` ไม่ขึ้น `latest`

> [!NOTE]
> ปลั๊กอินบางตัวกำหนดเวอร์ชันขั้นต่ำของระบบ (`minCore`) ถ้าระบบเก่ากว่า จะติดตั้งปลั๊กอินนั้นไม่ได้ และ Store แสดงว่า &#34;ต้องการระบบ vX+&#34;

## เว็บที่ติดตั้งก่อนมีฐานข้อมูลของ Site Code

`docker-compose.yml` รุ่นปัจจุบันต้องมี `CODE_DB_PASSWORD` และสคริปต์ `docker/mysql-init/10-site-code.sh` ทำงานเฉพาะตอน volume ฐานข้อมูลยังว่าง (ติดตั้งใหม่) เว็บที่ติดตั้งไว้ก่อนจึงต้องสร้างฐานข้อมูลเองครั้งเดียว:

1. ดาวน์โหลด `docker-compose.yml` และ `docker/mysql-init/10-site-code.sh` รุ่นใหม่ (เก็บ `.env` เดิมไว้) — คำสั่งเหมือนใน [เริ่มต้นใช้งาน](/docs/studio/getting-started)
2. เพิ่มใน `.env`:
    2 
3. เข้า MySQL ด้วย root แล้วรันคำสั่งด้านล่าง (ใช้รหัสผ่านเดียวกับ `CODE_DB_PASSWORD`)
    3 
    4 
4. `docker compose pull && docker compose up -d`

> [!NOTE]
> ระหว่างที่ยังไม่ได้ทำ Site Code ทำงานใน &#34;โหมดสำรอง&#34; (ตารางอยู่ในฐานข้อมูล CMS ขึ้นต้นด้วย `sc_`) หน้า **โค้ดของเว็บไซต์ → ฐานข้อมูล** แสดงคำสั่ง SQL ชุดนี้พร้อมชื่อฐานข้อมูลของคุณให้คัดลอก ดู [ฐานข้อมูลของ Site Code](/docs/developers/database)

## อัปเกรดเป็น 2.0: ปลั๊กอินในตัวย้ายไป Plugin Store

ตั้งแต่ 2.0 ระบบไม่มีปลั๊กอินติดมาในตัวแล้ว ความสามารถเดิม 7 อย่างเป็น **ปลั๊กอินทางการ** ที่ติดตั้งจาก Plugin Store และ &#34;สำรองข้อมูล&#34; กลายเป็นเครื่องมือในตัว [ส่งออก / นำเข้าเว็บ](/docs/studio/export-import)

| ปลั๊กอินเดิม | ปลั๊กอินทางการ (id) |
| --- | --- |
| สถิติผู้เข้าชม | `analytics` |
| SEO + sitemap | `seo` |
| ฟอร์มติดต่อ | `forms` |
| Redirects + 404 log | `redirects` |
| Cookie consent | `cookie-consent` |
| โหมดปิดปรับปรุง | `maintenance` |
| Custom code | `custom-code` |

### ระบบย้ายให้อัตโนมัติ

เมื่อเริ่มระบบเวอร์ชันใหม่ (และทุกนาทีหลังจากนั้น) ระบบดูปลั๊กอินเดิมที่ **เคยเปิดอยู่** หรือ **มีข้อมูลค้างอยู่** แล้วทำทีละตัว:

1. ดาวน์โหลดปลั๊กอินทางการจาก Store และตรวจว่าเป็นของทางการจริง
2. ติดตั้งและเปิดใช้ โดยอนุมัติสิทธิ์แทนผู้ดูแล — บันทึกไว้ว่า &#34;อนุมัติสิทธิ์โดย การย้ายอัตโนมัติ&#34; พร้อมเวลาและรายการสิทธิ์
3. คัดลอกการตั้งค่า (ชื่อค่าเหมือนเดิม) และย้ายข้อมูลเดิม เช่น ฟอร์มและข้อความที่ส่งมา (คงหมายเลขเดิม หน้าที่วางบล็อกฟอร์มไว้จึงใช้ต่อได้ทันที), กฎ redirect, ค่า SEO รายหน้า, สถิติ
4. ปลั๊กอินเดิมที่ **ปิดอยู่** แต่มีข้อมูล จะถูกติดตั้งและย้ายข้อมูล แต่ยังปิดไว้เหมือนเดิม

ระหว่างที่ยังย้ายไม่เสร็จ หลังบ้านแสดงแถบ **&#34;มีปลั๊กอิน N ตัวรอย้ายไปเป็นปลั๊กอินทางการ&#34;** ความสามารถนั้นจะปิดอยู่ชั่วคราว แต่ตัวเว็บใช้งานได้ปกติ

### ถ้าย้ายไม่สำเร็จ

- ระบบลองใหม่เองเป็นระยะ (1, 2, 4 … นาที สูงสุดทุกชั่วโมง) หรือกด **ลองอีกครั้ง**
- เว็บที่เชื่อมต่อ Store ไม่ได้: ดาวน์โหลดไฟล์ `.zip` ของปลั๊กอินทางการจากหน้าเว็บของ Plugin Store แล้วกด **อัปโหลดไฟล์ zip แทน**
- ดูสถานะทีละตัวได้ที่ **ปลั๊กอิน → ที่ติดตั้งเพิ่ม** ส่วน &#34;ย้ายจากปลั๊กอินในตัวเดิม&#34;

### ล้างข้อมูลเก่า

ข้อมูลเดิม **ไม่ถูกลบอัตโนมัติ** เมื่อตรวจแล้วว่าปลั๊กอินทางการทำงานถูกต้อง กด **ล้างข้อมูลเก่า** ที่ปลั๊กอินตัวนั้น เพื่อลบตารางและการตั้งค่าเดิมของปลั๊กอินในตัว (ข้อมูลในปลั๊กอินทางการไม่ได้รับผลกระทบ)

> [!WARNING]
> &#34;ล้างข้อมูลเก่า&#34; ทำย้อนกลับไม่ได้ — สำรองข้อมูลก่อนกด และกดได้หลังย้ายเสร็จแล้วเท่านั้น

> [!NOTE]
> ลิงก์ bypass ของโหมดปิดปรับปรุงเดิมใช้ไม่ได้หลังย้าย ผู้ทดสอบต้องเปิดลิงก์ bypass อีกครั้ง

## สิ่งที่ควรรู้ของเวอร์ชันหลัง ๆ

- **2.3.0** — หน้าจัดการเก็บ session ในคุกกี้ `HttpOnly` ทุกคนต้องเข้าสู่ระบบใหม่หนึ่งครั้งหลังอัปเดต และการกดบันทึกบนหน้าที่เผยแพร่แล้วในหน้าออกแบบจะเก็บเป็นฉบับร่างจนกว่าจะกดเผยแพร่
- **2.4.0** — แพ็กเกจจาก Plugin Store ทางการมีลายเซ็นและถูกตรวจก่อนติดตั้ง ไม่ต้องตั้งค่าอะไร และมีเมนู **บันทึกกิจกรรม** ให้ผู้ดูแลระบบ
