Como usar proxies com cURL: guia completo

TL;DR

Use os proxies da GProxy com cURL para requisições HTTP na linha de comando. Cobre os tipos de proxy HTTP, HTTPS e SOCKS5, autenticação e opções avançadas.

Obter proxies → cURL site →

Idioma: CLI

Pré-requisitos

✓[
✓"
✓c
✓U
✓R
✓L
✓
✓7
✓.
✓x
✓+
✓
✓i
✓n
✓s
✓t
✓a
✓l
✓a
✓d
✓o
✓
✓(
✓j
✓á
✓
✓v
✓e
✓m
✓
✓n
✓a
✓
✓m
✓a
✓i
✓o
✓r
✓i
✓a
✓
✓d
✓o
✓s
✓
✓s
✓i
✓s
✓t
✓e
✓m
✓a
✓s
✓)
✓"
✓,
✓
✓"
✓C
✓o
✓n
✓t
✓a
✓
✓G
✓P
✓r
✓o
✓x
✓y
✓
✓c
✓o
✓m
✓
✓p
✓l
✓a
✓n
✓o
✓
✓d
✓e
✓
✓p
✓r
✓o
✓x
✓y
✓
✓a
✓t
✓i
✓v
✓o
✓"
✓,
✓
✓"
✓A
✓c
✓e
✓s
✓s
✓o
✓
✓a
✓o
✓
✓t
✓e
✓r
✓m
✓i
✓n
✓a
✓l
✓
✓(
✓L
✓i
✓n
✓u
✓x
✓,
✓
✓m
✓a
✓c
✓O
✓S
✓
✓o
✓u
✓
✓W
✓i
✓n
✓d
✓o
✓w
✓s
✓
✓W
✓S
✓L
✓)
✓"
✓]

Configuração passo a passo

[

{

"

T

I

T

L

E

"

:

"

V

E

R

I

F

I

Q

U

E

S

E

O

C

U

R

L

E

S

T

Á

I

N

S

T

A

L

A

D

O

"

,

"

D

E

S

C

R

I

P

T

I

O

N

"

:

"

C

O

N

F

I

R

A

S

U

A

V

E

R

S

Ã

O

D

O

C

U

R

L

"

,

"

C

O

D

E

100

"

101

:

102

103

"

104

C

105

U

106

R

107

L

108

109

-

110

-

111

V

112

E

113

R

114

S

115

I

116

O

117

N

118

"

119

}

120

,

121

122

{

123

"

124

T

125

I

126

T

127

L

128

E

129

"

130

:

131

132

"

133

F

134

A

135

Ç

136

A

137

138

U

139

M

140

A

141

142

R

143

E

144

Q

145

U

146

I

147

S

148

I

149

Ç

150

Ã

151

O

152

153

B

154

Á

155

S

156

I

157

C

158

A

159

160

V

161

I

162

A

163

164

P

165

R

166

O

167

X

168

Y

169

"

170

,

171

172

"

173

D

174

E

175

S

176

C

177

R

178

I

179

P

180

T

181

I

182

O

183

N

184

"

185

:

186

187

"

188

U

189

S

190

E

191

192

A

193

194

F

195

L

196

A

197

G

198

199

-

200

X

201

202

P

203

A

204

R

205

A

206

207

P

208

A

209

S

210

S

211

A

212

R

213

214

P

215

E

216

L

217

A

218

219

G

220

P

221

R

222

O

223

X

224

Y

225

"

226

,

227

228

"

229

C

230

O

231

D

232

E

233

"

234

:

235

236

"

237

C

238

U

239

R

240

L

241

242

-

243

X

244

245

H

246

T

247

T

248

P

249

:

250

/

251

/

252

U

253

S

254

E

255

R

256

:

257

P

258

A

259

S

260

S

261

@

262

P

263

R

264

O

265

X

266

Y

267

.

268

G

269

P

270

R

271

O

272

X

273

Y

274

.

275

N

276

E

277

T

278

:

279

1

280

0

281

0

282

0

283

284

H

285

T

286

T

287

P

288

S

289

:

290

/

291

/

292

H

293

T

294

T

295

P

296

B

297

I

298

N

299

.

300

O

301

R

302

G

303

/

304

I

305

P

306

"

307

}

308

,

309

310

{

311

"

312

T

313

I

314

T

315

L

316

E

317

"

318

:

319

320

"

321

U

322

S

323

E

324

325

P

326

R

327

O

328

X

329

Y

330

331

S

332

O

333

C

334

K

335

S

336

5

337

"

338

,

339

340

"

341

D

342

E

343

S

344

C

345

R

346

I

347

P

348

T

349

I

350

O

351

N

352

"

353

:

354

355

"

356

R

357

O

358

T

359

E

360

I

361

E

362

363

P

364

E

365

L

366

O

367

368

E

369

N

370

D

371

P

372

O

373

I

374

N

375

T

376

377

S

378

O

379

C

380

K

381

S

382

5

383

"

384

,

385

386

"

387

C

388

O

389

D

390

E

391

"

392

:

393

394

"

395

C

396

U

397

R

398

L

399

400

-

401

X

402

403

S

404

O

405

C

406

K

407

S

408

5

409

:

410

/

411

/

412

U

413

S

414

E

415

R

416

:

417

P

418

A

419

S

420

S

421

@

422

P

423

R

424

O

425

X

426

Y

427

.

428

G

429

P

430

R

431

O

432

X

433

Y

434

.

435

N

436

E

437

T

438

:

439

1

440

0

441

0

442

1

443

444

H

445

T

446

T

447

P

448

S

449

:

450

/

451

/

452

H

453

T

454

T

455

P

456

B

457

I

458

N

459

.

460

O

461

R

462

G

463

/

464

I

465

P

466

"

467

}

468

,

469

470

{

471

"

472

T

473

I

474

T

475

L

476

E

477

"

478

:

479

480

"

481

C

482

O

483

N

484

F

485

I

486

G

487

U

488

R

489

E

490

491

O

492

493

G

494

E

495

O

496

-

497

T

498

A

499

R

500

G

501

E

502

T

503

I

504

N

505

G

506

"

507

,

508

509

"

510

D

511

E

512

S

513

C

514

R

515

I

516

P

517

T

518

I

519

O

520

N

521

"

522

:

523

524

"

525

D

526

I

527

R

528

E

529

C

530

I

531

O

532

N

533

E

534

535

P

536

A

537

R

538

A

539

540

U

541

M

542

543

P

544

A

545

Í

546

S

547

548

E

549

S

550

P

551

E

552

C

553

Í

554

F

555

I

556

C

557

O

558

"

559

,

560

561

"

562

C

563

O

564

D

565

E

566

"

567

:

568

569

"

570

C

571

U

572

R

573

L

574

575

-

576

X

577

578

H

579

T

580

T

581

P

582

:

583

/

584

/

585

U

586

S

587

E

588

R

589

-

590

C

591

O

592

U

593

N

594

T

595

R

596

Y

597

-

598

D

599

E

600

:

601

P

602

A

603

S

604

S

605

@

606

P

607

R

608

O

609

X

610

Y

611

.

612

G

613

P

614

R

615

O

616

X

617

Y

618

.

619

N

620

E

621

T

622

:

623

1

624

0

625

0

626

0

627

628

H

629

T

630

T

631

P

632

S

633

:

634

/

635

/

636

H

637

T

638

T

639

P

640

B

641

I

642

N

643

.

644

O

645

R

646

G

647

/

648

I

649

P

650

"

651

}

652

,

653

654

{

655

"

656

T

657

I

658

T

659

L

660

E

661

"

662

:

663

664

"

665

U

666

S

667

E

668

669

V

670

A

671

R

672

I

673

Á

674

V

675

E

676

I

677

S

678

679

D

680

E

681

682

A

683

M

684

B

685

I

686

E

687

N

688

T

689

E

690

"

691

,

692

693

"

694

D

695

E

696

S

697

C

698

R

699

I

700

P

701

T

702

I

703

O

704

N

705

"

706

:

707

708

"

709

D

710

E

711

F

712

I

713

N

714

A

715

716

O

717

718

P

719

R

720

O

721

X

722

Y

723

724

G

725

L

726

O

727

B

728

A

729

L

730

M

731

E

732

N

733

T

734

E

735

736

P

737

A

738

R

739

A

740

741

T

742

O

743

D

744

A

745

S

746

747

A

748

S

749

750

R

751

E

752

Q

753

U

754

I

755

S

756

I

757

Ç

758

Õ

759

E

760

S

761

"

762

,

763

764

"

765

C

766

O

767

D

768

E

769

"

770

:

771

772

"

773

E

774

X

775

P

776

O

777

R

778

T

779

780

H

781

T

782

T

783

P

784

_

785

P

786

R

787

O

788

X

789

Y

790

=

791

H

792

T

793

T

794

P

795

:

796

/

797

/

798

U

799

S

800

E

801

R

802

:

803

P

804

A

805

S

806

S

807

@

808

P

809

R

810

O

811

X

812

Y

813

.

814

G

815

P

816

R

817

O

818

X

819

Y

820

.

821

N

822

E

823

T

824

:

825

1

826

0

827

0

828

0

829

\

830

N

831

E

832

X

833

P

834

O

835

R

836

T

837

838

H

839

T

840

T

841

P

842

S

843

_

844

P

845

R

846

O

847

X

848

Y

849

=

850

H

851

T

852

T

853

P

854

:

855

/

856

/

857

U

858

S

859

E

860

R

861

:

862

P

863

A

864

S

865

S

866

@

867

P

868

R

869

O

870

X

871

Y

872

.

873

G

874

P

875

R

876

O

877

X

878

Y

879

.

880

N

881

E

882

T

883

:

884

1

885

0

886

0

887

0

888

\

889

N

890

C

891

U

892

R

893

L

894

895

H

896

T

897

T

898

P

899

S

900

:

901

/

902

/

903

H

904

T

905

T

906

P

907

B

908

I

909

N

910

.

911

O

912

R

913

G

914

/

915

I

916

P

917

"

918

}

919

,

920

921

{

922

"

923

T

924

I

925

T

926

L

927

E

928

"

929

:

930

931

"

932

T

933

E

934

S

935

T

936

E

937

938

C

939

O

940

M

941

942

S

943

A

944

Í

945

D

946

A

947

948

D

949

E

950

T

951

A

952

L

953

H

954

A

955

D

956

A

957

"

958

,

959

960

"

961

D

962

E

963

S

964

C

965

R

966

I

967

P

968

T

969

I

970

O

971

N

972

"

973

:

974

975

"

976

D

977

E

978

P

979

U

980

R

981

E

982

983

A

984

985

C

986

O

987

N

988

E

989

X

990

Ã

991

O

992

993

D

994

O

995

996

P

997

R

998

O

999

X

1000

Y

1001

1002

C

1003

O

1004

M

1005

1006

A

1007

1008

F

1009

L

1010

A

1011

G

1012

1013

-

1014

V

1015

"

1016

,

1017

1018

"

1019

C

1020

O

1021

D

1022

E

1023

"

1024

:

1025

1026

"

1027

C

1028

U

1029

R

1030

L

1031

1032

-

1033

V

1034

1035

-

1036

X

1037

1038

H

1039

T

1040

T

1041

P

1042

:

1043

/

1044

/

1045

U

1046

S

1047

E

1048

R

1049

:

1050

P

1051

A

1052

S

1053

S

1054

@

1055

P

1056

R

1057

O

1058

X

1059

Y

1060

.

1061

G

1062

P

1063

R

1064

O

1065

X

1066

Y

1067

.

1068

N

1069

E

1070

T

1071

:

1072

1

1073

0

1074

0

1075

0

1076

1077

H

1078

T

1079

T

1080

P

1081

S

1082

:

1083

/

1084

/

1085

H

1086

T

1087

T

1088

P

1089

B

1090

I

1091

N

1092

.

1093

O

1094

R

1095

G

1096

/

1097

I

1098

P

1099

"

1100

}

1101

]

Exemplos de código

Por que usar proxies com cURL?

O cURL é a ferramenta universal de linha de comando para requisições HTTP, instalada em praticamente todo sistema Linux, macOS e Windows. Adicionar proxies GProxy ao cURL permite testar conexões de proxy, depurar chamadas de API por IPs diferentes e criar shell scripts para coleta automatizada de dados. Com os 10M+ IPs residenciais da GProxy em 150+ países, você faz requisições de qualquer lugar direto do seu terminal.

Sintaxe básica do proxy

O cURL suporta proxies pela flag -x ou --proxy. O formato é -x protocol://user:pass@host:port. A GProxy suporta os protocolos HTTP, HTTPS e SOCKS5, todos configuráveis por essa única flag.

Métodos de autenticação

A GProxy suporta dois métodos de autenticação com cURL: credenciais inline na URL do proxy e autenticação por whitelist de IP (sem credenciais). Para auth inline, inclua seu usuário e senha diretamente na URL do proxy. Para whitelist de IP, basta adicionar o IP da sua máquina no painel da GProxy e usar o proxy sem credenciais.

SOCKS5 vs proxy HTTP

O cURL suporta proxies HTTP e SOCKS5. Use proxies HTTP (-x http://...) para requisições web padrão. Use SOCKS5 (-x socks5://...) quando precisar encaminhar tráfego não HTTP ou quando o destino exigir SOCKS5. A GProxy oferece as duas opções em portas diferentes.

Variáveis de ambiente

Defina o proxy para todas as requisições cURL usando variáveis de ambiente: export HTTP_PROXY=http://user:[email protected]:1000 e HTTPS_PROXY. Isso é útil em shell scripts e pipelines de CI/CD, quando você quer que todo o tráfego HTTP passe pela GProxy sem alterar cada comando.

Geo-targeting

Direcione para países específicos incluindo o código do país no seu usuário GProxy: USER-country-us, USER-country-de, etc. Isso roteia sua requisição por um IP residencial daquele país, essencial para testar APIs com restrição geográfica ou verificar conteúdo localizado.

Casos de uso

[

{

"

T

I

T

L

E

"

:

"

T

E

S

T

E

S

D

E

A

P

I

"

,

"

D

E

S

C

R

I

P

T

I

O

N

"

:

"

T

E

S

T

E

A

P

I

S

A

P

A

R

T

I

R

D

E

L

O

C

A

I

S

E

I

P

S

D

I

F

E

R

E

N

T

E

S

P

A

R

A

V

E

R

I

F

I

C

A

R

E

S

T

R

I

Ç

Õ

E

S

G

E

O

G

R

Á

F

I

C

A

S

E

O

C

O

M

P

O

R

T

A

M

E

N

T

O

D

E

R

A

T

E

L

I

M

I

T

I

N

G

.

"

}

,

{

"

T

I

T

L

E

"

:

"

A

U

T

O

M

A

Ç

Ã

O

C

O

M

S

H

E

L

S

C

R

I

P

T

"

,

"

D

E

S

C

R

I

P

T

I

O

N

"

:

"

C

R

I

E

S

C

R

I

P

T

S

D

E

C

O

L

E

T

A

D

E

D

A

D

O

S

Q

U

E

R

O

T

A

C

I

O

N

A

M

A

U

T

O

M

A

T

I

C

A

M

E

N

T

E

N

T

R

E

I

P

S

D

A

G

P

R

O

X

Y

.

"

}

,

{

"

T

I

T

L

E

"

:

"

T

E

S

T

E

D

E

C

O

N

E

X

Ã

O

D

O

P

R

O

X

Y

"

,

"

D

E

S

C

R

I

P

T

I

O

N

"

:

"

V

E

R

I

F

I

Q

U

E

R

A

P

I

D

A

M

E

N

T

E

S

U

A

S

C

R

E

D

E

N

C

I

A

I

S

G

P

R

O

X

Y

E

A

C

O

N

E

C

T

I

V

I

D

A

D

E

D

O

P

R

O

X

Y

P

E

L

A

L

I

N

H

A

D

E

C

O

M

A

N

D

O

.

"

}

,

{

"

T

I

T

L

E

"

:

"

I

N

T

E

G

R

A

Ç

Ã

O

C

O

M

P

I

P

E

L

I

N

E

D

E

C

I

/

C

D

"

,

"

D

E

S

C

R

I

P

T

I

O

N

"

:

"

R

O

T

E

I

E

A

S

R

E

Q

U

I

S

I

Ç

Õ

E

S

H

T

P

D

O

C

I

/

C

D

P

E

L

A

G

P

R

O

X

Y

U

S

A

N

D

O

V

A

R

I

Á

V

E

I

S

D

E

A

M

B

I

E

N

T

E

P

A

R

A

T

E

S

T

E

S

C

O

N

S

I

S

T

E

N

T

E

S

.

"

}

]

Dicas Pro

Use a flag -w para medir tempos de resposta através do proxy. Adicione --connect-timeout 10 para falhar rápido em problemas de proxy. Use um arquivo .curlrc para configuração de proxy persistente. Encaminhe a saída para o jq e faça o parsing de JSON nos scripts.