[{"_1":2,"_189":-5,"_190":-5},"loaderData",{"_3":4,"_18":19,"_26":27,"_162":163},"root",{"_5":-5,"_6":-7,"_7":8,"_9":-7,"_10":11,"_12":-7,"_13":14,"_15":16,"_17":11},"currentUser","primaryEmail","siteVerification","6LeIxAcTAAAAAJcZVRqyHh71UMIEGNQ_MXjiZKhI","toast","enableDev",false,"incidentStatus","theme","system","contrast","normal","dockerRebrandTour","routes/_layout",{"_20":-5,"_21":22,"_23":22,"_24":11,"_25":22},"username","isAskGordonEnabled",true,"isUsingNewTemplate","showMinimalLanding","showHoneypotTrap","routes/_layout.r.$namespace.$reponame",{"_28":29,"_30":-5,"_31":11,"_32":11,"_33":34,"_35":36,"_37":-5,"_38":11,"_39":40,"_89":-5,"_90":91,"_150":-5,"_151":11,"_152":22,"_153":11,"_154":11,"_155":-5,"_156":11,"_157":-5,"_158":159,"_160":92,"_161":-7},"canonicalUrl","https://hub.docker.com/r/napadon/volume-backup/tags","mcpServer","canSeeDockerfile","canSeeAutobuilds","namespace","napadon","reponame","volume-backup","cloudBuildSource","isAutobuildsAvailable","repo",{"_41":42,"_43":44,"_46":47,"_48":49,"_50":11,"_51":52,"_53":54,"_55":56,"_58":36,"_33":34,"_59":60,"_61":45,"_62":63,"_64":65,"_66":67,"_68":-5,"_69":63,"_70":71,"_72":11,"_73":34,"_74":75,"_80":11,"_81":82,"_86":34,"_87":88},"categories",[],"content_types",[45],"image","date_registered","2026-02-23T06:49:34.982532Z","description","","is_private","last_updated","2026-02-23T08:08:33.083682Z","last_modified","2026-02-23T07:57:23.723137Z","media_types",[57],"application/vnd.oci.image.index.v1+json","name","pull_count",514,"repository_type","star_count",0,"status",1,"status_description","active","source","collaborator_count","full_description","# Docker Volume Backup to NAS (FTP/SFTP)\n

🌍 English | 🇹🇭 ภาษาไทย

\n\n---\n\n

🇬🇧 English

\n\nA lightweight Docker image based on Alpine Linux for automating backups of your Docker Volumes. It compresses your data into `.tar.gz` and automatically uploads it to a NAS or remote server via FTP or SFTP.\n\n### 🌟 Key Features\n- **Automated Scheduling**: Powered by `cron` to run backups at any interval you define.\n- **Retention Policy (GFS)**: Keep your storage clean! Retains Daily (7 days), Weekly (4 weeks), and Monthly (forever) backups. Alternatively, limit by absolute count or days.\n- **Secure Transfer**: Supports SFTP/FTP protocols with `lftp` and `openssh-client` for secure offsite storage.\n- **Lightweight**: Built on Alpine, ensuring minimal footprint and fast deployment.\n\n### 🚀 Quick Start (via Docker Compose)\n\nHere's an example `docker-compose.yml` configuration:\n\n```yaml\nversion: '3.8'\n\nservices:\n volume-backup:\n image: napadon/volume-backup:latest\n container_name: volume_backup_service\n environment:\n - BACKUP_PREFIX=my_data\n - TZ=Asia/Bangkok\n - CRON_SCHEDULE=0 2 * * *\n \n # Retention Policy\n - RETENTION_COUNT=14\n # - RETENTION_DAYS=30\n \n # NAS Upload\n - UPLOAD_PROTOCOL=sftp\n - NAS_HOST=192.168.1.100\n - NAS_USER=nas_user\n - NAS_PASS=nas_password\n - NAS_DIR=/home/backups\n volumes:\n - /path/to/your/data:/data:ro\n restart: unless-stopped\n```\n\n### ⚙️ Environment Variables\n\n| Variable | Default Value | Description |\n|---|---|---|\n| `BACKUP_SOURCE` | `/data` | Path inside the container to backup data from. |\n| `BACKUP_DEST` | `/backup` | Local path to temporarily store `.tar.gz` before upload. |\n| `BACKUP_PREFIX` | `backup` | Prefix for the generated backup file (e.g. `prefix_2026...tar.gz`). |\n| `TZ` | `Asia/Bangkok` | Timezone setting for accurate cron scheduling. |\n| `CRON_SCHEDULE` | `0 2 * * *` | Cron expression defining the backup frequency. |\n| `RETENTION_COUNT` | (Empty) | Hard limit on the number of backup files to keep. (Overrides GFS on NAS if used locally) |\n| `RETENTION_DAYS` | (Empty) | Number of days to keep backup files locally. |\n| `UPLOAD_PROTOCOL` | (Empty) | Protocol to use: `sftp` or `ftp`. |\n| `NAS_HOST` | (Empty) | Hostname or IP address of the target NAS/Server. |\n| `NAS_USER` | (Empty) | Username for NAS authentication. |\n| `NAS_PASS` | (Empty) | Password for NAS authentication. |\n| `NAS_DIR` | (Empty) | Target directory on the NAS to store backups. |\n\n---\n\n

🇹🇭 ภาษาไทย

\n\nImage สำหรับ Docker ขนาดเล็ก (สร้างจาก Alpine) ถูกออกแบบมาเพื่อสำรองข้อมูล (Backup) จาก Docker Volume ของคุณโดยอัตโนมัติ ระบบจะทำการบีบอัดไฟล์ให้อยู่ในรูปแบบ `.tar.gz` จากนั้นจะอัปโหลดไปยังหน่วยเก็บข้อมูลภายนอก (NAS) ผ่าน FTP หรือ SFTP ให้ทันที\n\n### 🌟 ความสามารถหลัก\n- **ตั้งเวลาสำรองอัตโนมัติ**: ควบคุมความถี่ในการ Backup ผ่าน `cron` ได้อย่างยืดหยุ่นด้วยรูปแบบเวลาที่ต้องการ\n- **นโยบายลบไฟล์อัตโนมัติ (GFS Retention)**: เคลียร์พื้นที่เก็บข้อมูลให้ว่างเสมอ! สคริปต์จะเก็บไฟล์สุดท้ายของวันไว้ (7 วันล่าสุด), สัปดาห์ (4 สัปดาห์ล่าสุด), และเดือน (เก็บถาวร) อย่างเป็นระบบ หรือจะเลือกใช้แค่จำกัดจำนวนวันทั่วไปก็ได้\n- **ปลอดภัยหายห่วง**: รองรับการส่งไฟล์ออกไปภายนอกด้วยโปรโตคอล SFTP (ผ่าน OpenSSH และ lftp)\n- **กินสเปคน้อย**: ถูกสร้างขึ้นบนระบบปฏิบัติการ Alpine ที่เบาบาง ทำให้โหลดเร็วและไม่เปลืองทรัพยากรเซิร์ฟเวอร์\n\n### 🚀 วิธีการใช้งานเบื้องต้น (ผ่าน Docker Compose)\n\nตัวอย่างการตั้งค่าไฟล์ `docker-compose.yml` เพื่อเรียกใช้งาน:\n\n```yaml\nversion: '3.8'\n\nservices:\n volume-backup:\n image: napadon/volume-backup:latest\n container_name: volume_backup_service\n environment:\n - BACKUP_PREFIX=my_data # คำนำหน้าไฟล์เพื่อระบุประเภทข้อมูล\n - TZ=Asia/Bangkok # ตั้งให้เวลาตรงตามทวีปเอเชีย/ไทย\n - CRON_SCHEDULE=0 2 * * * # ตั้งเวลาทำงาน (ในที่นี้คือ ตี 2 ทุกวัน)\n \n # ตั้งเงื่อนไขการเก็บไฟล์ใน NAS หรือเครื่อง (Retention Policy)\n - RETENTION_COUNT=14 # เก็บไว้ 14 ชุด ถ้าเกินจะลบอันเก่าทิ้ง\n # - RETENTION_DAYS=30 # (ทางเลือก) ลบไฟล์ที่เก่ากว่า 30 วัน\n \n # การตั้งค่าเพื่ออัปโหลดลงระบบ NAS\n - UPLOAD_PROTOCOL=sftp # โปรโตคอล (sftp หรือ ftp)\n - NAS_HOST=192.168.1.100 # ไอพีของเซิร์ฟเวอร์สำรองข้อมูล\n - NAS_USER=nas_user # ชื่อผู้ใช้งาน\n - NAS_PASS=nas_password # รหัสผ่าน \n - NAS_DIR=/home/backups # โฟลเดอร์ปลายทาง\n volumes:\n - /path/to/your/data:/data:ro # (แนะนำให้ชี้ Data แบบ Read-only เพื่อป้องกันผิดพลาด)\n restart: unless-stopped\n```\n\n### ⚙️ ตัวแปร (Environment Variables) ที่รองรับ\n\n| ตัวแปร | ค่าตั้งต้น (Default) | คำอธิบาย |\n|---|---|---|\n| `BACKUP_SOURCE` | `/data` | Path ตำแหน่งโฟลเดอร์ฝั่ง Container ที่ต้องการมัดรวม Backup |\n| `BACKUP_DEST` | `/backup` | Path สำหรับไว้พักไฟล์ `.tar.gz` ชั่วคราวก่อนส่งขึ้น NAS |\n| `BACKUP_PREFIX` | `backup` | ข้อความนำหน้าชื่อไฟล์ |\n| `TZ` | `Asia/Bangkok` | โซนเวลา เพื่อให้เข้าจังหวะกับ Cron job |\n| `CRON_SCHEDULE` | `0 2 * * *` | เลขความถี่ของ Cron ตั้งกติกาทำงาน |\n| `RETENTION_COUNT` | (ไม่ระบุ) | จำนวนไฟล์รวมทั้งหมดที่จะเก็บไว้สลับลบทิ้ง (ถ้ามีจะข้ามกฎ GFS บน NAS) |\n| `RETENTION_DAYS` | (ไม่ระบุ) | จำนวนวันสูงสุดที่จะเก็บไฟล์ |\n| `UPLOAD_PROTOCOL` | (ไม่ระบุ) | ใช้สำหรับโยนทาง `sftp` หรือ `ftp` |\n| `NAS_HOST` | (ไม่ระบุ) | IP หรือ Host ของ NAS ปลายทาง |\n| `NAS_USER` | (ไม่ระบุ) | ชื่อบัญชีล็อกอิน NAS |\n| `NAS_PASS` | (ไม่ระบุ) | รหัสผ่าน NAS |\n| `NAS_DIR` | (ไม่ระบุ) | ไดเรกทอรีบนเครื่อง NAS เพื่อเก็บข้อมูล |\n\n---\n**Author**: *Napadon* **(AI Generated)**\n**License**: MIT\n","has_starred","hub_user","immutable_tags_settings",{"_76":11,"_77":78},"enabled","rules",[79],".*","is_automated","permissions",{"_83":22,"_84":11,"_85":11},"read","write","admin","user","storage_size",13468245,"orgData","recentTags",[92,138],{"_93":45,"_94":95,"_96":97,"_98":99,"_100":101,"_102":103,"_51":126,"_127":95,"_128":34,"_129":57,"_58":130,"_131":132,"_133":134,"_135":126,"_136":67,"_137":22},"content_type","creator",5958050,"digest","sha256:f2a3d98a2aade1db378388a7e46d5ae36bb808830c84a2b85caba77cdc906d4a","full_size",13450970,"id",1082361454,"images",[104,119],{"_105":106,"_96":107,"_108":49,"_109":110,"_111":112,"_113":114,"_115":49,"_116":-5,"_117":99,"_64":67,"_118":-5},"architecture","amd64","sha256:6aca6fcdda4511bb81f9ff6ff7f58e3080ba089ac40bf2b011cb83238f306a73","features","last_pulled","2026-10-20T03:28:34.308929098Z","last_pushed","2026-02-23T08:07:56.342042693Z","os","linux","os_features","os_version","size","variant",{"_105":120,"_96":121,"_108":49,"_109":122,"_111":123,"_113":120,"_115":49,"_116":-5,"_117":124,"_64":125,"_118":-5},"unknown","sha256:9666de4f873b117a1ae0ec62107eb0e9e4b00644ba10d70ac2e15b630330b263","2026-08-18T08:59:49.022500969Z","2026-02-23T08:07:56.300805557Z",1009,"inactive","2026-02-23T08:07:57.523565Z","last_updater","last_updater_username","media_type","latest","repository",30186965,"tag_last_pulled","2026-10-20T03:28:34.95789412Z","tag_last_pushed","tag_status","v2",{"_93":45,"_94":95,"_96":139,"_98":99,"_100":140,"_102":141,"_51":148,"_127":95,"_128":34,"_129":57,"_58":149,"_131":132,"_133":110,"_135":148,"_136":67,"_137":22},"sha256:8f2386697bb372c9ff20d2a3198bae476902807a6cd881f924712c88e79ac261",1082361731,[142,143],{"_105":106,"_96":107,"_108":49,"_109":110,"_111":112,"_113":114,"_115":49,"_116":-5,"_117":99,"_64":67,"_118":-5},{"_105":120,"_96":144,"_108":49,"_109":145,"_111":146,"_113":120,"_115":49,"_116":-5,"_117":147,"_64":125,"_118":-5},"sha256:17e6e07df1d1b439b9bef043fe0baaf6bf08f61be2ca95dfeb169a26ae035bdc","2026-08-20T06:58:40.732229932Z","2026-02-23T08:08:30.95351384Z",1008,"2026-02-23T08:08:31.937984Z","1.0.0","sbxKitMetadata","isPotentialSpam","isHubSbxKitsEnabled","showSbxRunInCloud","showSbxLogoOverride","sbxTrademarkText","displaySecurityMetadata","tagAttestations","tagsHaveAttestations",[],"selectedTag","attestationsUrl","routes/_layout.r.$namespace.$reponame.tags",{"_39":164,"_171":172,"_158":187,"_188":11},{"_41":165,"_43":166,"_46":47,"_48":49,"_50":11,"_51":52,"_53":54,"_55":167,"_58":36,"_33":34,"_59":60,"_61":45,"_62":63,"_64":65,"_66":67,"_68":-5,"_69":63,"_70":71,"_72":11,"_73":34,"_74":168,"_80":11,"_81":170,"_86":34,"_87":88},[],[45],[57],{"_76":11,"_77":169},[79],{"_83":22,"_84":11,"_85":11},"tags",{"_173":174,"_175":-5,"_176":-5,"_177":178},"count",2,"next","previous","results",[179,183],{"_93":45,"_94":95,"_96":139,"_98":99,"_100":140,"_102":180,"_51":148,"_127":95,"_128":34,"_129":57,"_58":149,"_131":132,"_133":110,"_135":148,"_136":67,"_137":22},[181,182],{"_105":106,"_96":107,"_108":49,"_109":110,"_111":112,"_113":114,"_115":49,"_116":-5,"_117":99,"_64":67,"_118":-5},{"_105":120,"_96":144,"_108":49,"_109":145,"_111":146,"_113":120,"_115":49,"_116":-5,"_117":147,"_64":125,"_118":-5},{"_93":45,"_94":95,"_96":97,"_98":99,"_100":101,"_102":184,"_51":126,"_127":95,"_128":34,"_129":57,"_58":130,"_131":132,"_133":134,"_135":126,"_136":67,"_137":22},[185,186],{"_105":106,"_96":107,"_108":49,"_109":110,"_111":112,"_113":114,"_115":49,"_116":-5,"_117":99,"_64":67,"_118":-5},{"_105":120,"_96":121,"_108":49,"_109":122,"_111":123,"_113":120,"_115":49,"_116":-5,"_117":124,"_64":125,"_118":-5},[],"canDeleteTags","actionData","errors"]

napadon/volume-backup

Tags for napadon/volume-backup