myfreebuff

Helper CLI untuk Freebuff — jalankan Freebuff melalui proxy terisolasi & reset sesi login dengan satu perintah.

Tersedia untuk Linux, macOS, dan Windows.

Fitur

Proxy terisolasi — proxy hanya berlaku di dalam proses Freebuff; koneksi lain di sistem tetap direct
Cek IP egress — verifikasi IP exit proxy sebelum menjalankan Freebuff
Reset sesi — hapus kredensial & instance lock dengan satu perintah
Peringatan sticky — mengingatkan bila proxy tampak tidak sticky (Freebuff butuh IP tetap)
Password masking — kredensial proxy di-mask di output terminal
Auto-detect — CA bundle & direktori config dideteksi otomatis per OS
Tanpa hardcoded credentials — tidak ada API key, host, atau kredensial di dalam script

⚠️ Wajib: Gunakan Proxy Sticky

Freebuff mengikat sesi login ke IP. Jika IP berubah di tengah sesi, sesi akan pecah dan akun berisiko tersuspend.

Jenis	Perilaku	Untuk Freebuff
Sticky	IP tetap selama sesi berlangsung	✅ Wajib pakai ini
Rotating	IP berubah setiap request	❌ Jangan dipakai

Cara mengaktifkan sticky

Setiap penyedia proxy punya cara berbeda. Umumnya salah satu dari:

Metode	Contoh format
Session ID di username	`user-session-abc123`, `user_sid_abc123`
Port khusus sticky	`host:10001` (port sticky) vs `host:8080` (rotating)
Parameter tambahan	`user?session=abc123`
Endpoint terpisah	`sticky.provider.com` vs `rotating.provider.com`

Cek dokumentasi penyedia proxy Anda untuk format yang benar.

Verifikasi sticky

Jalankan --check beberapa kali — IP harus sama:

PROXY="http://USER:PASS@HOST:PORT"

myfreebuff proxy --proxy "$PROXY" --check
myfreebuff proxy --proxy "$PROXY" --check
myfreebuff proxy --proxy "$PROXY" --check

✔ Egress IP: 203.0.113.45 (Singapore, SG) - AS64496 Example ISP
✔ Egress IP: 203.0.113.45 (Singapore, SG) - AS64496 Example ISP   ← sama = sticky ✅
✔ Egress IP: 203.0.113.45 (Singapore, SG) - AS64496 Example ISP

Jika IP berubah-ubah, proxy Anda rotating — jangan dipakai untuk Freebuff.

myfreebuff akan memberi peringatan bila URL proxy tidak memuat penanda session yang umum. Ini hanya heuristik — verifikasi tetap dengan --check.

Prasyarat: Install Freebuff CLI

myfreebuff adalah wrapper — Freebuff CLI harus terpasang lebih dulu.

npm install -g freebuff

Butuh Node.js 18+. Belum punya Node.js? Unduh di nodejs.org.

Verifikasi:

node --version      # harus v18.0.0 atau lebih baru
freebuff --version

Dokumentasi resmi: freebuff.com/cli

Freebuff gratis — tanpa API key dan tanpa kartu kredit.

Instalasi myfreebuff

Linux / macOS

curl -fsSL https://raw.githubusercontent.com/capncodes69/myfreebuff/main/install.sh | bash

Terpasang ke ~/.local/bin/myfreebuff secara default.

Kustomisasi direktori instalasi:

INSTALL_DIR=/usr/local/bin curl -fsSL https://raw.githubusercontent.com/capncodes69/myfreebuff/main/install.sh | bash

Windows (PowerShell)

irm https://raw.githubusercontent.com/capncodes69/myfreebuff/main/install.ps1 | iex

Terpasang ke %LOCALAPPDATA%\Programs\myfreebuff secara default.

Kustomisasi direktori instalasi:

$env:INSTALL_DIR = "C:\Tools\myfreebuff"
irm https://raw.githubusercontent.com/capncodes69/myfreebuff/main/install.ps1 | iex

Manual

Linux / macOS

curl -fsSL -o myfreebuff https://raw.githubusercontent.com/capncodes69/myfreebuff/main/myfreebuff.sh
chmod +x myfreebuff
mkdir -p ~/.local/bin
mv myfreebuff ~/.local/bin/

Pastikan ~/.local/bin ada di $PATH:

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc && source ~/.bashrc

Windows

$dir = "$env:LOCALAPPDATA\Programs\myfreebuff"
New-Item -ItemType Directory -Path $dir -Force | Out-Null
irm https://raw.githubusercontent.com/capncodes69/myfreebuff/main/myfreebuff.ps1 -OutFile "$dir\myfreebuff.ps1"

# Shim agar bisa dipanggil sebagai 'myfreebuff'
@"
@echo off
powershell -NoLogo -NoProfile -ExecutionPolicy Bypass -File "%~dp0myfreebuff.ps1" %*
"@ | Set-Content "$dir\myfreebuff.cmd" -Encoding ASCII

# Tambahkan ke PATH
[Environment]::SetEnvironmentVariable('Path', "$([Environment]::GetEnvironmentVariable('Path','User'));$dir", 'User')

Verifikasi:

myfreebuff version

Pemakaian

Alur normal

# Simpan URL proxy sticky Anda sekali
PROXY="http://USER:PASS@HOST:PORT"

# 1. Verifikasi proxy sticky (jalankan 2x, IP harus sama)
myfreebuff proxy --proxy "$PROXY" --check
myfreebuff proxy --proxy "$PROXY" --check

# 2. Login Freebuff lewat proxy tersebut
myfreebuff proxy --proxy "$PROXY" login

# 3. Pemakaian selanjutnya — SELALU lewat proxy yang sama
myfreebuff proxy --proxy "$PROXY"

Penting: Selalu jalankan Freebuff lewat myfreebuff proxy. Menjalankan freebuff langsung akan memakai koneksi asli Anda (tanpa proxy) dan dapat memicu deteksi karena IP berbeda dari saat login.

Cek IP egress proxy

myfreebuff proxy --proxy "http://USER:PASS@HOST:PORT" --check

==> Proxy: http://USER:***@HOST:PORT
==> Memeriksa IP egress...
  ✔ Egress IP: 203.0.113.45 (Singapore, SG) - AS64496 Example ISP

Jika akun tersuspend

# 1. Bersihkan sesi login lama
myfreebuff reset

# 2. Login lagi dengan proxy sticky yang menghasilkan IP BARU
myfreebuff proxy --proxy "http://USER:PASS@HOST:PORT" login

==> Reset Freebuff...
==> Config: /home/user/.config/manicode
  ✔ Proses Freebuff dibersihkan
  ✔ Sesi login terhapus (2 file)

==> Selesai. Login akun baru dengan proxy sticky:
  myfreebuff proxy --proxy "http://USER:PASS@HOST:PORT" login

  ! Pakai proxy sticky dengan IP BARU agar tidak memakai IP yang tersuspend.

Cara mendapat IP baru bergantung penyedia proxy Anda — biasanya dengan mengganti session ID, port sticky, atau me-refresh session dari dashboard penyedia. Verifikasi IP sudah berubah dengan --check sebelum login.

Lainnya

myfreebuff version    # tampilkan versi
myfreebuff -h         # bantuan

Contoh Lengkap

Setup pertama kali

# 1. Install Freebuff CLI (jika belum)
npm install -g freebuff

# 2. Install myfreebuff
curl -fsSL https://raw.githubusercontent.com/capncodes69/myfreebuff/main/install.sh | bash

# 3. Simpan proxy sticky ke environment agar tidak perlu diulang
export MYFREEBUFF_PROXY="http://USER:PASS@HOST:PORT"

# 4. Verifikasi sticky
myfreebuff proxy --check
myfreebuff proxy --check    # IP harus sama

# 5. Login
myfreebuff proxy login

# 6. Pemakaian harian
myfreebuff proxy

Agar permanen, tambahkan ke shell profile:

echo 'export MYFREEBUFF_PROXY="http://USER:PASS@HOST:PORT"' >> ~/.bashrc
source ~/.bashrc

Rotasi akun (ganti akun + IP)

myfreebuff reset

# Ganti ke proxy sticky dengan IP berbeda
export MYFREEBUFF_PROXY="http://USER:PASS@HOST:PORT"

myfreebuff proxy --check     # pastikan IP berbeda dari sebelumnya
myfreebuff proxy login

Ganti negara exit

Sebagian penyedia proxy mendukung penargetan geografis. Formatnya berbeda-beda — cek dokumentasi penyedia Anda:

# Contoh: sebagian penyedia memakai parameter di username
myfreebuff proxy --proxy "http://USER-country-SG:PASS@HOST:PORT" --check

# Contoh: sebagian memakai endpoint/port berbeda per negara
myfreebuff proxy --proxy "http://USER:PASS@sg.HOST:PORT" --check

Format Proxy

http://USER:PASS@HOST:PORT
https://USER:PASS@HOST:PORT
socks5://USER:PASS@HOST:PORT

Pastikan proxy Anda sticky — lihat Wajib: Gunakan Proxy Sticky.

Format Proxy

http://user:pass@host:port
https://user:pass@host:port
socks5://user:pass@host:port

Tambahkan session ID agar sticky — lihat Wajib: Gunakan Proxy Sticky.

Environment Variables

Variable	Deskripsi
`MYFREEBUFF_PROXY`	Proxy default, dipakai jika `--proxy` tidak diberikan
`FREEBUFF_CONFIG_DIR`	Override lokasi direktori config Freebuff
`INSTALL_DIR`	Target direktori saat instalasi
`MYFREEBUFF_REF`	Branch/tag yang diunduh installer (default: `main`)

Contoh:

export MYFREEBUFF_PROXY="http://USER:PASS@HOST:PORT"
myfreebuff proxy --check
myfreebuff proxy login

Cara Kerja

Subcommand	Deskripsi
`proxy`	Set `HTTP_PROXY` / `HTTPS_PROXY` / `ALL_PROXY` di environment proses, lalu jalankan `freebuff`
`reset`	Hentikan proses Freebuff, hapus `credentials.json` & `freebuff-instance-owner.json`

Proxy hanya di-export ke proses anak (freebuff) — tidak mempengaruhi koneksi lain di sistem dan tidak menulis konfigurasi global apa pun.

Lokasi config yang dideteksi

OS	Path
Linux	`$XDG_CONFIG_HOME/manicode` atau `~/.config/manicode`
macOS	`~/Library/Application Support/manicode` atau `~/.config/manicode`
Windows	`%APPDATA%\manicode` atau `%LOCALAPPDATA%\manicode`

Persyaratan

Komponen	Kebutuhan
Freebuff CLI	`npm install -g freebuff` (Node.js 18+)
Linux / macOS	`bash` 4+, `curl`
Windows	PowerShell 5.1+
Proxy	Sticky (IP tetap)

Troubleshooting

Akun tersuspend / sesi ditolak Umumnya karena IP berubah di tengah sesi — proxy rotating, atau Freebuff dijalankan langsung (freebuff) setelah login lewat proxy.

myfreebuff reset
myfreebuff proxy --proxy "http://USER:PASS@HOST:PORT" login

Pastikan proxy menghasilkan IP baru (verifikasi dengan --check), lalu selalu jalankan lewat myfreebuff proxy.

Proxy tidak memuat penanda session/sticky Peringatan ini muncul bila URL proxy tidak mengandung kata seperti sid, session, atau sticky. Ini hanya heuristik — beberapa penyedia mengaktifkan sticky lewat port atau endpoint khusus, bukan username.

Verifikasi manual dengan --check 2–3 kali. Jika IP tetap sama, proxy Anda sudah sticky dan peringatan bisa diabaikan.

IP berubah-ubah padahal mengira sudah sticky Proxy Anda rotating. Hubungi penyedia atau cek dokumentasinya untuk cara mengaktifkan sticky session. Jangan pakai proxy ini untuk Freebuff.

Binary 'freebuff' tidak ditemukan di PATH Install Freebuff CLI:

npm install -g freebuff

Butuh Node.js 18+ — cek dengan node --version.

Gagal terhubung ke proxy / timeout Verifikasi kredensial dan konektivitas proxy langsung:

curl -x "http://USER:PASS@HOST:PORT" https://ipinfo.io/json

CA bundle sistem tidak ditemukan Install paket sertifikat sistem:

# Debian/Ubuntu
sudo apt install ca-certificates
# RHEL/Fedora
sudo dnf install ca-certificates
# macOS
brew install ca-certificates

Windows: myfreebuff tidak dikenali Buka terminal baru agar perubahan PATH terbaca.

Lisensi

MIT

capncodes69/myfreebuff

Star growth

README

myfreebuff

Fitur

⚠️ Wajib: Gunakan Proxy Sticky

Cara mengaktifkan sticky

Verifikasi sticky

Prasyarat: Install Freebuff CLI

Instalasi myfreebuff

Linux / macOS

Windows (PowerShell)

Manual

Pemakaian

Alur normal

Cek IP egress proxy

Jika akun tersuspend

Lainnya

Contoh Lengkap

Setup pertama kali

Rotasi akun (ganti akun + IP)

Ganti negara exit

Format Proxy

Format Proxy

Environment Variables

Cara Kerja

Lokasi config yang dideteksi

Persyaratan

Troubleshooting

Lisensi