SSD Nodes Learn Hosting plans →
Mwongozo Matt ConnorNa Matt Connor

Jinsi ya Kuendesha MinIO kwenye VPS ya Ubuntu 24.04

Sanidi MinIO kwenye VPS moja ya Ubuntu 24.04 kwa API ya S3 unayoimiliki, build iliyothibitishwa, systemd, mc, presigned URLs na lengwa la restic.

Verified Every command ran end-to-end on a fresh Ubuntu 24.04 server, July 30, 2026.

Faida za kutumia MinIO kama hifadhi ya vitu (object storage) inayojiendesha

MinIO ni hifadhi ya vitu inayojiendesha (self-hosted) inayotumia API ya Amazon S3. Elekeza restic au S3 SDK kwenye seva yako, badilisha mpangilio mmoja wa endpoint, na kwa shughuli za kila siku za kusoma, kuandika, kuorodhesha vitu na viungo vilivyotiwa saini (presigned links), hayo ndiyo yote yanayohitajika. Hata hivyo, kuwa sambamba (compatible) hakumaanishi kuwa sawa kabisa. Kwa mfano, MinIO haitekelezi ACL za vitu za Amazon, hivyo programu inayotegemea tabia ya ACL inahitaji zaidi ya kubadilisha endpoint tu. Mwongozo huu unajenga node moja kwenye Ubuntu 24.04: binary iliyokusanywa kutoka chanzo kilichothibitishwa, mtumiaji maalum wa mfumo, unit ya systemd inayoweka vitambulisho vya root nje ya faili ya unit, na bucket ambayo restic inatumia kuhifadhi nakala.

S3 (simple storage service) ni HTTP API badala ya mfumo wa faili (filesystem). Unaweka (PUT) kitu kwenye bucket chini ya key na unakipata (GET) tena, na katika bucket ya kawaida hakuna uandishi wa sehemu (partial write) wala kubadilisha jina (rename). Directory buckets za Amazon S3 Express One Zone ni ubaguzi, zikiwa na wito wa append na rename, lakini hiyo ni darasa moja la hifadhi na hakuna chochote katika mwongozo huu kinachotegemea hilo. Zana za kuhifadhi nakala (backup tools) zinapenda mfumo huu wa kawaida, kwa sababu kitu kimefika kikiwa kizima au hakikufika kabisa.

Node moja inashikilia nakala moja ya data yako. Huo ndio mabadilishano unayofanya. Unapata S3 endpoint unayoimiliki kwa gharama ya VPS, na pia unarithi kila kazi ambayo mtoa huduma wa wingu alikuwa akifanya, kuanzia kubadilisha diski iliyoharibika hadi kusasisha programu ya seva. Sehemu iliyo karibu na mwisho inaeleza wazi wakati ambapo mabadilishano hayo ni ya manufaa.

Hali ya toleo la jamii la MinIO mnamo Oktoba 2026

Soma sehemu hii kabla ya kuendeleza kazi yako, kwa sababu mambo yamebadilika hivi karibuni. Mnamo Mei 2025, MinIO iliondoa vipengele vya usimamizi kutoka kwenye dashibodi ya wavuti katika toleo la jamii. Kilichobaki kwenye kivinjari ni kivinjari cha object, kwa hivyo ndoo (buckets) na access keys sasa husimamiwa kwa kutumia mc command line client.

Baadaye mwaka wa 2025, MinIO iliacha kutoa binaries za toleo la jamii zilizokwisha kusanywa (pre-compiled). README ya mradi inasema toleo la jamii husambazwa kama source code pekee, na tangu Aprili 2026, hazina ya minio/minio imewekwa kwenye kumbukumbu chini ya notisi ya THIS REPOSITORY IS NO LONGER MAINTAINED. Seva ya zamani ya kupakua faili pia imeacha kutoa faili za toleo la jamii. Ilipokaguliwa tarehe 20 Oktoba 2026, kila njia ya dl.min.io ambayo mwongozo huu ulikuwa ukitumia kupakua binary ya seva, binary ya client, na faili zao za checksum, inajibu 410 Gone, jambo ambalo ni uondoaji wa makusudi badala ya hitilafu ya seva. Marejeleo ya AIStor CLI sasa yanaelekeza kwenye AIStor Client chini ya /aistor/mc/release/, ambayo ni sehemu ya bidhaa za kibiashara. Ukurasa wa kupakua kwenye min.io sasa unaorodhesha AIStor Server, AIStor Client, AIStor SDK na nyongeza chache za AIStor, na kutangaza jaribio la miezi miwili la AIStor. Ukurasa wake wa bei bado unaorodhesha ngazi ya bure ya AIStor inayolenga watengenezaji programu, watafiti, na mashirika madogo yanayoendesha mifumo ya pekee (standalone deployments).

Source code bado ipo, na ni mpya zaidi kuliko binary ya mwisho. Toleo la mwisho la jamii ni RELEASE.2025-10-15T17-29-55Z, lililochapishwa tarehe 16 Oktoba 2025 kama toleo la usalama: linarekebisha upandishaji wa mamlaka (privilege escalation) kupitia bypass ya sera ya kikao katika akaunti za huduma na STS, na maelezo ya toleo yanawashauri watumiaji wote kuboresha mara moja. Binary ya mwisho iliyokusanywa ilikuwa ya Septemba 2025, kwa hivyo haikupata marekebisho hayo. Mwongozo huu unakusanya (compile) toleo la Oktoba, na kwa sababu hazina hiyo imewekwa kwenye kumbukumbu, hili ndilo marekebisho ya mwisho ambayo toleo la jamii litapata.

Ukweli huo mmoja unaathiri mwongozo huu wote. Ndiyo sababu MinIO hapa inasikiliza kwenye 127.0.0.1 na kufikia mtandao kupitia proksi unayoimiliki pekee.

Sakinisha binary ya MinIO na uhakiki upakuaji

MinIO imeandikwa kwa Go, na README ya muuzaji inaijenga kwa amri moja ya go install inayohitaji Go 1.24 au mpya zaidi. Sakinisha Go kutoka kwenye tarball rasmi kwanza. Mnamo 11 Novemba 2026 toleo thabiti la sasa kwenye go.dev/dl ni go1.27.4, lililotolewa mnamo 10 Novemba 2026 likiwa na marekebisho ya usalama kwa cgo, amri ya Go, compiler, linker na kifurushi cha net/http, na hash iliyo hapa chini ndiyo iliyochapishwa kwenye ukurasa huo kwa ajili ya archive ya linux-amd64. Ukichagua Go mpya zaidi, chukua hash yake kutoka kwenye ukurasa uleule. Flag ya -f huifanya curl kufeli kwenye hitilafu ya HTTP badala ya kuhifadhi ukurasa wa hitilafu kwa jina uliloomba, jambo ambalo ndilo huwafanya watu kuishia kufungua (unpack) ukurasa wa 404 na kujiuliza kwa nini si archive.

cd /tmp
GOVER=go1.27.4
curl -fsSL "https://go.dev/dl/$GOVER.linux-amd64.tar.gz" -o go.tar.gz

Linganisha hash hizo mbili, na ulinganishe hash pekee.

published=7226736c2339719cda28fbf3a54d71aa63bcefe376e98cef00034268dab24840
downloaded=$(sha256sum go.tar.gz | awk '{print $1}')
[ "$published" = "$downloaded" ] && echo "checksum ok"

Kuwa wazi kuhusu kile ambacho ukaguzi huu unathibitisha. Ulinganifu unathibitisha kuwa upakuaji umekamilika na haukuharibiwa au kubadilishwa wakati wa usafirishaji. Haithibitishi kuwa muuzaji anastahili kuaminiwa. Hilo ni tatizo tofauti na hakuna amri ya sha256sum inayoweza kulitatua.

sudo rm -rf /usr/local/go
sudo tar -C /usr/local -xzf go.tar.gz
export PATH=$PATH:/usr/local/go/bin
go version

Sasa jenga toleo la mwisho la jamii (community release) kama mtumiaji wako wa kawaida. go install hukagua kila moduli inayopakua, ikiwemo source code ya MinIO yenyewe, dhidi ya hifadhidata ya checksum ya umma ya Go iliyo kwenye sum.golang.org, kwa hivyo moduli iliyochezewa au kubadilishwa husimamisha ujenzi kwa hitilafu ya usalama badala ya kutoa binary.

go install github.com/minio/minio@RELEASE.2025-10-15T17-29-55Z
sudo install -o root -g root -m 755 ~/go/bin/minio /usr/local/bin/minio
minio --version
go version -m /usr/local/bin/minio | head -n 3

minio --version huchapisha DEVELOPMENT.GOGET mahali ambapo jina la toleo lilikuwa, kwa sababu go install haitumii flag za ujenzi ambazo muuzaji alitumia kupiga chapa binary zake. go version -m husoma taarifa za moduli ambazo Go huingiza kwenye kila binary, na mstari wake wa mod github.com/minio/minio hutaja commit uliyojenga. Permission denied hapa inamaanisha hali (mode) si sahihi, na command not found inamaanisha /usr/local/bin haipo kwenye PATH yako. Ikiwa VPS haina kumbukumbu ya kutosha kwa ajili ya compile, endesha go install ileile kwenye mashine nyingine ya Linux yenye usanifu (architecture) uleule na unakili binary hiyo.

Unda mtumiaji wa mfumo na saraka ya data

MinIO hupokea upload kutoka kwenye mtandao, kwa hivyo haipaswi kuendeshwa kama root. Ipe akaunti isiyo na home directory na isiyo na login shell.

sudo groupadd -r minio-user
sudo useradd -M -r -g minio-user -s /usr/sbin/nologin minio-user
sudo mkdir -p /var/lib/minio/data
sudo chown -R minio-user:minio-user /var/lib/minio
sudo chmod 750 /var/lib/minio

-r hutengeneza akaunti ya mfumo yenye UID chini ya 1000, jambo linaloiweka nje ya masafa yanayotumiwa na watu. -M huruka home directory, kwa sababu akaunti isiyowahi kuingia kwenye mfumo haina kitu cha kuhifadhi humo. Hakikisha matokeo kwa id minio-user, na kwa stat -c '%U %a' /var/lib/minio, ambayo inapaswa kuchapisha minio-user 750.

Saraka ya data lazima iweze kuandikika na mtumiaji huyo, si kusomeka tu. Katika kuanza kwa mara ya kwanza, MinIO hutengeneza saraka ya .minio.sys ndani ya volume ili kuhifadhi usanidi wake, kwa hivyo saraka inayomilikiwa na root husababisha MinIO kusitisha utendaji wakati wa kuanza ikiwa na ujumbe unaoishia na permission denied. Kanuni hiyo hiyo inatumika kwa kila huduma unayoiendesha kwa njia hii, na watumiaji wa huduma wenye upendeleo mdogo kwenye VPS inaelezea hili kwa kina.

Weka vitambulisho vya root kwenye faili la mazingira

Vitambulisho vya root hufungua kila bucket, kwa hivyo havipaswi kuwekwa kwenye unit file, ambayo inaweza kusomwa na kila mtu. Unda faili hilo kwa mode sahihi kwanza kisha uandike ndani yake baadaye, ili nenosiri lisikae kwenye faili linaloweza kusomwa hata kwa muda mfupi.

sudo install -o root -g root -m 600 /dev/null /etc/default/minio
printf 'MINIO_ROOT_USER=minio-root\nMINIO_ROOT_PASSWORD=%s\nMINIO_VOLUMES="/var/lib/minio/data"\nMINIO_OPTS="--address 127.0.0.1:9000 --console-address 127.0.0.1:9001"\n' "$(openssl rand -base64 24)" | sudo tee /etc/default/minio > /dev/null
sudo sed -n 's/^MINIO_ROOT_PASSWORD=//p' /etc/default/minio

tee hufuta yaliyomo kwenye faili lililopo badala ya kuliunda upya, kwa hivyo mode inabaki 600 na mmiliki anabaki kuwa root. Hilo ni la makusudi. systemd husoma EnvironmentFile kama root kabla ya kushusha mamlaka hadi User=, jambo linalomaanisha kuwa akaunti ya huduma haihitaji kamwe kusoma vitambulisho vyake yenyewe. Huduma ikishaanza kufanya kazi, ithibitishe kwa sudo -u minio-user cat /etc/default/minio. Amri hiyo lazima ichapishe Permission denied.

Tabia mbili za MinIO zinafaa kujulikana kabla ya kuianzisha. Bila MINIO_ROOT_USER na bila MINIO_ROOT_PASSWORD kwenye mazingira yake, MinIO haikatai kuanza. Inaanza na vitambulisho chaguo-msingi vilivyoandikwa kwenye nyaraka vya minioadmin:minioadmin, ambavyo ni jozi ya kwanza inayojaribiwa na kila skana, na inaonekana kuwa salama kabisa wakati inafanya hivyo. Nenosiri lenye chini ya herufi 8 hukataliwa badala yake: MinIO husimama wakati wa kuanza na kutoa hitilafu inayosema vitambulisho si sahihi, kwa sababu access key inahitaji angalau herufi 3 na secret key angalau 8.

MINIO_VOLUMES ndiyo njia ya data na MINIO_OPTS hushikilia flags. Kujifunga kwenye 127.0.0.1 inamaanisha hakuna kitu nje ya VPS hii kinachoweza kufikia S3 API kwa sasa, ambayo ndiyo hali chaguo-msingi sahihi. Utaifungua kwa makusudi baadaye, kupitia proxy inayoshikilia cheti.

Andika unit ya systemd

Tengeneza /etc/systemd/system/minio.service:

[Unit]
Description=MinIO object storage
Documentation=https://github.com/minio/minio
Wants=network-online.target
After=network-online.target

[Service]
User=minio-user
Group=minio-user
EnvironmentFile=/etc/default/minio
ExecStart=/usr/local/bin/minio server $MINIO_VOLUMES $MINIO_OPTS
Restart=always
RestartSec=5
NoNewPrivileges=true

[Install]
WantedBy=multi-user.target

Hakuna - ya mwanzo kwenye EnvironmentFile, na huu ni uamuzi makusudi siyo kosa la uchapaji. Kwa kutumia dash, systemd hupuuza faili lisilopatikana na kuanzisha MinIO hata hivyo, kwa hivyo faili lililofutwa au njia iliyoandikwa vibaya itakupa seva inayofanya kazi kwenye minioadmin:minioadmin kimyakimya. Bila dash, faili lisilopatikana husababisha unit kufeli kabla MinIO haijaanza, na journalctl -u minio inaonyesha Failed to load environment files: No such file or directory. Unit inayokataa kuanza ni rahisi zaidi kuigundua kuliko seva inayokubali nenosiri chaguo-msingi kimyakimya.

$MINIO_VOLUMES na $MINIO_OPTS hazijawekwa kwenye alama za kunukuu kwa makusudi, kwa sababu systemd hugawa vigezo visivyo na alama za kunukuu kulingana na nafasi (whitespace) kuwa hoja tofauti. Hivyo ndivyo maneno manne katika MINIO_OPTS yanavyokuwa hoja nne kwa minio server. MinIO huongeza kikomo chake cha soft file descriptor hadi kikomo cha hard kilichorithiwa wakati wa kuanza. Chaguo-msingi la systemd ni 1024 kwa soft na 524288 kwa hard, kwa hivyo kuweka LimitNOFILE=65536 kungepunguza kikomo cha MinIO hadi 65536. Unit hii haijumuishi override hiyo.

sudo systemctl daemon-reload
sudo systemctl enable --now minio
systemctl is-active minio
curl -fsS -o /dev/null -w '%{http_code}\n' http://127.0.0.1:9000/minio/health/live

is-active inapaswa kuchapisha active, na endpoint ya afya inapaswa kujibu 200. journalctl -u minio -n 20 --no-pager inaonyesha anwani ya API ambayo seva inasikiliza. Ikiwa unit inaendelea kuanza upya, soma kosa kabla ya kila kuanza upya kwenye journal. Kwa RestartSec=5, kutoka mara kwa mara hakuzidi kikomo cha kuanza cha systemd cha mara tano katika sekunde kumi, kwa hivyo unit inaendelea kujaribu. Start request repeated too quickly inamaanisha kikomo cha kiwango cha kuanza kilichosanidiwa kimefikiwa.

Kwa kutengwa zaidi, ongeza ProtectSystem=full na ProtectHome=true kwenye sehemu ya [Service]. Zote zinahitaji mount namespaces kutoka kwa kernel ya mwenyeji (host). Kwenye virtualization ya container inayoshiriki kernel ya mwenyeji, kama vile OpenVZ au LXC, zinaweza kufeli, na unit kisha inaripoti status=226/NAMESPACE. Ondoa mistari hiyo miwili na itaanza. Unit yenyewe ni ya kawaida, na huduma za systemd na vipima muda kwenye VPS inashughulikia maelekezo mengine yote.

Sakinisha mc na uthibitishe mzunguko wa data

MinIO client ni mc. Usiisakinishe kwa kutumia apt install mc. Kifurushi hicho ni Midnight Commander, meneja wa faili asiyehusiana na MinIO.

Njia ya zamani ya jamii, https://dl.min.io/client/mc/release/linux-amd64/mc, inajibu 410 Gone. Rejeleo la AIStor CLI sasa linaelekeza kwenye AIStor Client katika https://dl.min.io/aistor/mc/release/linux-amd64/mc na kuielezea kama yenye utendaji wa kipekee kwa ajili ya usakinishaji wa AIStor Server wenye leseni. Rejeleo hilo halisemi chochote kuhusu kuitumia dhidi ya seva ya jamii, kwa hivyo mwongozo huu unaendelea kutumia mteja wa jamii. Hifadhi ya minio/mc imewekwa kwenye kumbukumbu tangu Julai 2026, kwa hivyo jenga toleo lake la mwisho, RELEASE.2025-08-13T08-35-41Z, kwa kutumia Go toolchain ileile. Hifadhi ya checksum inashughulikia upakuaji huu pia.

go install github.com/minio/mc@RELEASE.2025-08-13T08-35-41Z
sudo install -o root -g root -m 755 ~/go/bin/mc /usr/local/bin/mc

Sajili seva kama alias, kisha uhamishe kitu kupitia hiyo seva.

MINIO_PASS=$(sudo sed -n 's/^MINIO_ROOT_PASSWORD=//p' /etc/default/minio)
mc alias set local http://127.0.0.1:9000 minio-root "$MINIO_PASS"
mc mb local/backups
echo "hello object storage" > /tmp/hello.txt
mc cp /tmp/hello.txt local/backups/hello.txt
mc ls local/backups
mc cat local/backups/hello.txt

mc ls inapaswa kuorodhesha hello.txt pamoja na ukubwa wake, na mc cat inapaswa kuchapisha hello object storage. Mzunguko huo wa data ndio uthibitisho halisi kwamba seva inafanya kazi, kwa sababu inafanya maombi yaleyale yaliyotiwa saini ya S3 ambayo kila mteja mwingine atafanya. mc admin info local huchapisha hali ya seva ikiwa unataka maoni ya pili.

Fanya ukaguzi mwingine sasa, wakati seva bado haina kitu.

mc alias set defaultcheck http://127.0.0.1:9000 minioadmin minioadmin

Amri hii lazima ifeli. Ikiwa itafanikiwa, faili ya mazingira haikufika kwenye mchakato na seva yako inaendeshwa kwa kutumia vitambulisho chaguo-msingi. Rekebisha hilo kabla ya kitu kingine chochote kugusa mashine hiyo.

mc huhifadhi alias katika ~/.mc/config.json kwa maandishi wazi, kwa hivyo vitambulisho hivyo hukaa kwenye saraka ya nyumbani ya yeyote aliyeendesha amri hiyo. Kuendesha mc chini ya sudo huweka vitambulisho vya root katika /root/.mc/config.json. Weka alias ya root kwenye akaunti moja ya msimamizi na upe kila programu ufunguo wake binafsi.

Toa kitu kimoja kwa URL iliyosainiwa mapema

URL iliyosainiwa mapema ni kiungo cha kawaida cha HTTPS chenye sahihi na muda wa kuisha. Mtu yeyote aliye na kiungo hicho anaweza kupakua kitu hicho kimoja bila akaunti na bila client.

mc share download --expire 12h local/backups/hello.txt

Matokeo yana X-Amz-Signature na X-Amz-Expires kwenye query string. Kuna mambo mawili kuhusu matokeo hayo yanayowashangaza watu. Kiungo hujengwa kwa endpoint iliyo kwenye alias uliyotumia, kwa hiyo alias iliyo kwenye 127.0.0.1 hutengeneza kiungo ambacho kinaweza kufunguliwa na mashine hii pekee: tengeneza alias ya pili kwenye hostname yako ya umma kwa viungo unavyokusudia kutuma. Pia hakuna kitufe cha kubatilisha kiungo kimoja. Sahihi hubaki halali hadi muda wake wa kuisha ufike au key iliyotumika kukisaini iondolewe au ibadilishwe. Kwa kiungo kilichosainiwa kwa credentials za root, hilo linamaanisha kuzibadilisha. Kwa hiyo, muda mfupi wa kuisha ndiyo udhibiti wa vitendo. Siku 7 ndiyo muda wa juu unaoruhusiwa na muundo wa sahihi wa S3.

Ipa restic ufunguo na bucket yake yenyewe

Vitambulisho vya root vinaweza kusoma na kufuta kila bucket, kwa hivyo kazi ya backup haipaswi kuvishikilia. Unda bucket, sera iliyopunguzwa kwa bucket hiyo, na mtumiaji asiyepata kitu kingine chochote.

mc mb local/restic
cat > /tmp/restic-rw.json <<'EOF'
{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": ["s3:ListBucket", "s3:GetBucketLocation"],
      "Resource": ["arn:aws:s3:::restic"]
    },
    {
      "Effect": "Allow",
      "Action": ["s3:GetObject", "s3:PutObject", "s3:DeleteObject"],
      "Resource": ["arn:aws:s3:::restic/*"]
    }
  ]
}
EOF
RESTIC_KEY=$(openssl rand -base64 24)
mc admin policy create local restic-rw /tmp/restic-rw.json
mc admin user add local restic-backup "$RESTIC_KEY"
mc admin policy attach local restic-rw --user restic-backup

MinIO inakuja na sera ya ndani ya readwrite ambayo ingekuwa fupi kwa amri moja, na inatoa ufikiaji kamili kwa kila bucket kwenye seva. Sera iliyo hapo juu inataja bucket mara mbili kwa makusudi: mara moja kama arn:aws:s3:::restic ili kuorodhesha bucket kufanye kazi, na mara moja kama arn:aws:s3:::restic/* kwa ajili ya vitu vilivyomo ndani yake. Katika S3, bucket na vitu vyake ni rasilimali tofauti, kwa hivyo sera inayotaja moja tu kati ya hizo itashindwa kwa njia inayoonekana kama mteja aliyeharibika.

Jaribu kikomo kabla ya kukiwekea imani.

mc alias set resticuser http://127.0.0.1:9000 restic-backup "$RESTIC_KEY"
mc ls resticuser/restic
mc ls resticuser/backups

Amri ya kwanza ya ls inafanikiwa na ya pili inashindwa na Access Denied. Sera ambayo hujaijaribu ni kubahatisha.

Sasa elekeza restic kwenye bucket hiyo. restic inasoma vitambulisho vya S3 kutoka kwa vigezo vya mazingira vya kawaida vya AWS, kwa hivyo hakuna faili ya vitambulisho maalum ya restic inayohusika.

sudo apt install -y restic
export AWS_ACCESS_KEY_ID=restic-backup
export AWS_SECRET_ACCESS_KEY="$RESTIC_KEY"
restic -r s3:http://127.0.0.1:9000/restic init
restic -r s3:http://127.0.0.1:9000/restic backup /etc
restic -r s3:http://127.0.0.1:9000/restic snapshots

restic init inaomba nenosiri la hazina (repository). Nenosiri hilo husimba hazina kwa njia fiche, kwa hivyo MinIO huhifadhi maandishi fiche pekee, na kupoteza nenosiri kunamaanisha kupoteza backup. Uendeshaji ulioanzishwa na systemd timer hauna terminal ya kuandikia, kwa hivyo weka RESTIC_PASSWORD_FILE kwenye faili ya mode 600 kwa ajili ya backups zilizopangwa.

Kanuni moja ya uwekaji ni muhimu zaidi kuliko amri yoyote hapo juu. Hazina ya restic iliyo kwenye VPS moja na data inayolinda inakuokoa tu dhidi ya rm mbaya na si kitu kingine. Node ya MinIO inapaswa kuwa mashine tofauti, ikiwezekana katika eneo tofauti la kijiografia. restic backups kwenye VPS inashughulikia upangaji na uhifadhi wa muda mrefu zaidi ya hili.

Kumalizia TLS kwa kutumia nginx

MinIO inakaa kwenye localhost, kwa hivyo nginx ndiyo sehemu inayotazamana na umma. Toa cheti kwanza, kama ilivyoelezwa katika vyeti vya Let's Encrypt kwa kutumia certbot na nginx, kisha tumia block hii ya server.

server {
    listen 443 ssl;
    server_name s3.example.com;

    ignore_invalid_headers off;
    client_max_body_size 0;
    proxy_buffering off;
    proxy_request_buffering off;

    location / {
        proxy_set_header Host $http_host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_connect_timeout 300;
        proxy_http_version 1.1;
        proxy_set_header Connection "";
        chunked_transfer_encoding off;
        proxy_pass http://127.0.0.1:9000;
    }
}

Mistari kadhaa kati ya hiyo ni muhimu sana. client_max_body_size 0 huondoa kikomo cha kawaida cha 1 MB cha body, ambacho kingekataa upakiaji wowote mkubwa zaidi kwa 413 Request Entity Too Large kabla ya MinIO kuona ombi hilo. proxy_request_buffering off hupitisha upakiaji moja kwa moja, kwa sababu mpangilio wa kawaida huhifadhi ombi zima kwenye faili ya muda kwanza, na kitu kikubwa basi huhitaji nafasi ya diski mara mbili. proxy_set_header Host $http_host ni ya hila: sahihi ya S3 inashughulikia header ya Host, kwa hivyo proxy inayoiandika upya hufanya kila ombi kushindwa kwa SignatureDoesNotMatch wakati logi ya ufikiaji ikionyesha ombi la kawaida likifika.

Iambie MinIO jina lake la umma pia, ili viungo inavyotengeneza vionyeshe kwenye proxy badala ya localhost.

echo 'MINIO_SERVER_URL=https://s3.example.com' | sudo tee -a /etc/default/minio
sudo systemctl restart minio

Firewall inabaki ndogo. Ruhusu SSH na HTTPS, na uache port 9000 na 9001 bila sheria yoyote, kwa sababu anwani iliyofungwa kwenye 127.0.0.1 haiwezi kufikiwa kutoka kwa mashine nyingine bila kujali firewall inasema nini. misingi ya ufw firewall kwenye VPS ina amri hizo.

Wakati MinIO ya node moja inatosha, na wakati unahitaji S3 halisi

Node moja hapa inamaanisha diski moja, kwa hivyo hakuna parity wala nakala ya pili ndani ya deployment, na uimara wa kila kitu ni uimara wa diski moja ya VPS. Nyaraka za jamii za MinIO zinapatikana kama chanzo katika repository ya minio/docs baada ya nyaraka zilizokuwa zikihifadhiwa na jamii kuondolewa mnamo Oktoba 2025. README ya seva yake inasema mazingira ya uzalishaji yanayotumia binaries zilizokusanywa kutoka kwenye chanzo hufanya hivyo kwa hatari yao wenyewe. Object locking inaweza kuwashwa kwa ajili ya bucket, lakini kwenye VPS moja inazuia tu ufutaji kupitia S3 API. Mtu yeyote mwenye root kwenye mashine bado anaweza kuondoa faili kwenye diski, kwa hivyo usimwahidi mtu yeyote sera ya uhifadhi isiyoweza kubadilika (immutable retention policy) kwenye usanidi huu.

Hii inafaa kama lengo la restic kwenye VPS ya pili katika eneo lingine, na kama endpoint ya S3 kwa ajili ya kazi za maendeleo na CI artifacts, ambapo kupoteza bucket kunagharimu tu ujenzi upya na si kingine. Pia ni busara kwa ajili ya uploads za watumiaji katika programu ndogo, mradi tu unamiliki mpango wa urejeshaji na umefanya majaribio ya restore.

Chagua S3 inayodhibitiwa (managed S3) wakati mkataba au mdhibiti anapohitaji object lock au uimara wa maeneo mengi (multi-region durability), au wakati hutaki kuwa mtu anayepigiwa simu saa 03:00 kwa sababu diski imejaa. Kanuni zilizogandishwa (frozen code) ni sababu nyingine ya kweli. Kufikia 20 Oktoba 2026 toleo la jamii limehifadhiwa na halitunzwi tena, na toleo lake la mwisho, RELEASE.2025-10-15T17-29-55Z, ndilo ambalo mwongozo huu unakusanya. Hakuna kitakachorekebishwa baada ya hapo, kwa hivyo kukiendesha kunamaanisha kukubali hali hiyo, au kuhamia kwenye laini ya kibiashara ya MinIO ya AIStor au kwenye hifadhi nyingine ya self-hosted, ambayo njia mbadala za MinIO ya self-hosted inalinganisha.

Kikomo kimoja kinastahili kutajwa kwa sababu hujitokeza mara nyingi. Object storage si database. Katika bucket ya kawaida, kila uandishi hubadilisha kitu kizima, na hata wito wa append ambao Amazon iliongeza kwa S3 Express One Zone huongeza data tu mwishoni, kwa hivyo faili ya SQL inayotumika kwenye bucket ya S3 ni polepole na si salama. Weka database kwenye diski ya ndani na uihifadhi kwenye bucket badala yake: kuendesha SQLite katika uzalishaji kwenye VPS inaelezea mgawanyo huo.

Aina za kushindwa na ujumbe utakaoona

Kitengo hushindwa mara tu baada ya systemctl enable --now. Soma journalctl -u minio -n 30 --no-pager. Failed to load environment files: No such file or directory inamaanisha kuwa /etc/default/minio haipo au njia yake imeandikwa vibaya kwenye unit. Ujumbe unaoishia na permission denied unamaanisha kuwa service account haina ruhusa ya kuandika kwenye data directory, kwa hiyo hakikisha stat -c '%U' /var/lib/minio/data inachapisha minio-user.

minioadmin:minioadmin bado inaingia. Environment file haikufika kwenye process. Thibitisha kuwa unit ina EnvironmentFile=/etc/default/minio, endesha sudo systemctl daemon-reload, kisha uwashe upya service. MinIO husoma root credentials mara moja wakati wa startup, kwa hiyo kuhariri file hilo bila kuwasha upya hakubadilishi chochote.

Address already in use wakati wa startup. Process nyingine inatumia port 9000. Itafute kwa sudo ss -ltnp | grep :9000 kabla ya kubadilisha port ya MinIO.

Uploads zinazozidi 1 MB hushindwa kupitia proxy. nginx ilijibu 413 Request Entity Too Large na MinIO haikuwahi kuona request. Weka client_max_body_size 0 kwenye server block.

SignatureDoesNotMatch. Aidha secret key si sahihi, au kitu kati ya client na MinIO kilibadilisha Host header, ambayo signature inajumuisha.

RequestTimeTooSkewed. Saa ya client au server si sahihi. Kila S3 request iliyotiwa saini huwa na timestamp, na MinIO, kama Amazon S3, hukataa request iliyotiwa saini kupitia header ikiwa timestamp yake inatofautiana na saa yake kwa zaidi ya dakika 15. Presigned links hukaguliwa kulingana na muda wao wa kuisha. Kagua timedatectl na uthibitishe kuwa time synchronisation imewashwa.

Access Denied kwenye bucket unayojua ipo. Key imewekewa ruhusa za bucket tofauti. Chapisha kile ambacho policy inaruhusu kwa kutumia mc admin policy info local restic-rw, kisha linganisha jina la bucket kwenye resource lines.

FAQ

Je, MinIO ya node moja inatosha kwa backups za kweli?

Inatosha kama target ya restic inayofanya kazi kwenye mashine tofauti na data inayolindwa. Haitoshi kama nakala yako pekee. Deployment ya diski moja haina parity yoyote, kwa hivyo hakuna nakala ya pili ndani ya MinIO, na kama diski ya VPS hiyo ikipoteza data, object hizo hupotea. Weka target ya pili mahali pengine, na ufanye restore kutoka kwa zote mbili angalau mara moja ili uhakikishe mchakato unafanya kazi.

Kwa nini sha256sum -c inafeli kwenye faili ya checksum ya MinIO?

Njia za zamani za dl.min.io zilijibu 410 Gone kwa kila binary ya jamii na faili ya checksum iliyotumiwa na mwongozo huu ilipokaguliwa tarehe 20 Oktoba 2026. Lebo iliyo baada ya hash ndani ya faili hiyo hutaja release, kama vile minio.RELEASE.2025-09-07T16-13-09Z, wakati faili iliyopakuliwa kwa kawaida huitwa minio. sha256sum -c hutafuta faili yenye jina lililoandikwa ndani ya faili ya checksum, haioni, na kuripoti No such file or directory na WARNING: 1 listed file could not be read. Upakuaji uko sawa. Linganisha hash strings moja kwa moja na upuuze lebo hiyo, ambayo haina maana yoyote ya kiusalama.

Console ya utawala ya MinIO ya mtandao imeenda wapi?

MinIO iliondoa vipengele vya utawala kutoka kwenye console ya toleo la jamii mnamo Mei 2025, na kuacha kivinjari cha object kwenye interface ya mtandao. Buckets na watumiaji sasa husimamiwa kwa kutumia client ya mc, kwa kutumia amri kama mc admin user add na mc admin policy attach. Hiyo ndiyo njia iliyokusudiwa katika toleo la jamii badala ya njia mbadala, ndiyo maana mwongozo huu unafanya kila kitu kutoka kwenye command line.

Ninawezaje kuelekeza restic kwenye MinIO kama S3 backend?

Weka AWS_ACCESS_KEY_ID na AWS_SECRET_ACCESS_KEY kwenye access key ya MinIO na siri yake, kisha tumia repository string ya mfumo wa s3:https://s3.example.com/restic, ambapo kipengele cha mwisho cha njia ni jina la bucket. Unda bucket kwanza kwa mc mb, kwa sababu key iliyowekewa mipaka kwenye bucket moja haina ruhusa ya kuunda buckets. restic husimba kila kitu kwa nenosiri lake la repository kabla ya kupakia, kwa hivyo MinIO huhifadhi ciphertext na haioni faili zako kamwe.

Je, lazima niendeshe MinIO nyuma ya nginx?

Unahitaji TLS (transport layer security) wakati wowote mteja anapokuwa hayuko kwenye mashine hiyo hiyo, kwa sababu bila hiyo kila object huvuka mtandao ikiwa katika maandishi wazi (plain text), pamoja na access key ID na sahihi ya ombi (request signature). Secret key yenyewe haitoki kwa mteja, kwa kuwa usaini wa S3 huitumia ndani ya mfumo ili kukokotoa sahihi hiyo, lakini mtu yeyote aliye kwenye njia anaweza kusoma data yako na kurudia ombi lililonaswa wakati timestamp yake bado ni halali. Proxy kwenye port 443 yenye cheti kutoka kwa certbot ndiyo njia rahisi zaidi ya kupata TLS, na huweka usasishaji wa cheti mbali na MinIO. MinIO inaweza pia kumalizia TLS yenyewe ukielekeza --certs-dir kwenye saraka inayoshikilia public.crt na private.key, lakini hapo service account itahitaji ruhusa ya kusoma private key iliyosasishwa, ambayo ni kazi ya ziada kwa matokeo yaleyale.

Je, makala hii ilikusaidia?

#minio#s3#object-storage#self-hosted#vps