How to Use Proxies with cURL: Complete Guide

TL;DR

Use GProxy proxies with cURL for command-line HTTP requests. Covers HTTP, HTTPS, SOCKS5 proxy types, authentication, and advanced options.

Get Proxies → cURL website →

Language: CLI

Prerequisites

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

Step-by-Step Setup

[

{

"

T

I

T

L

E

"

:

"

V

E

R

I

F

Y

C

U

R

L

I

S

I

N

S

T

A

L

E

D

"

,

"

D

E

S

C

R

I

P

T

I

O

N

"

:

"

C

H

E

C

K

Y

O

U

R

C

U

R

L

V

E

R

S

I

O

N

"

,

"

C

O

D

E

"

:

"

C

U

R

L

-

V

E

100

R

101

S

102

I

103

O

104

N

105

"

106

}

107

,

108

109

{

110

"

111

T

112

I

113

T

114

L

115

E

116

"

117

:

118

119

"

120

M

121

A

122

K

123

E

124

125

A

126

127

B

128

A

129

S

130

I

131

C

132

133

P

134

R

135

O

136

X

137

I

138

E

139

D

140

141

R

142

E

143

Q

144

U

145

E

146

S

147

T

148

"

149

,

150

151

"

152

D

153

E

154

S

155

C

156

R

157

I

158

P

159

T

160

I

161

O

162

N

163

"

164

:

165

166

"

167

U

168

S

169

E

170

171

-

172

X

173

174

F

175

L

176

A

177

G

178

179

T

180

O

181

182

R

183

O

184

U

185

T

186

E

187

188

T

189

H

190

R

191

O

192

U

193

G

194

H

195

196

G

197

P

198

R

199

O

200

X

201

Y

202

"

203

,

204

205

"

206

C

207

O

208

D

209

E

210

"

211

:

212

213

"

214

C

215

U

216

R

217

L

218

219

-

220

X

221

222

H

223

T

224

T

225

P

226

:

227

/

228

/

229

U

230

S

231

E

232

R

233

:

234

P

235

A

236

S

237

S

238

@

239

P

240

R

241

O

242

X

243

Y

244

.

245

G

246

P

247

R

248

O

249

X

250

Y

251

.

252

N

253

E

254

T

255

:

256

1

257

0

258

0

259

0

260

261

H

262

T

263

T

264

P

265

S

266

:

267

/

268

/

269

H

270

T

271

T

272

P

273

B

274

I

275

N

276

.

277

O

278

R

279

G

280

/

281

I

282

P

283

"

284

}

285

,

286

287

{

288

"

289

T

290

I

291

T

292

L

293

E

294

"

295

:

296

297

"

298

U

299

S

300

E

301

302

S

303

O

304

C

305

K

306

S

307

5

308

309

P

310

R

311

O

312

X

313

Y

314

"

315

,

316

317

"

318

D

319

E

320

S

321

C

322

R

323

I

324

P

325

T

326

I

327

O

328

N

329

"

330

:

331

332

"

333

R

334

O

335

U

336

T

337

E

338

339

T

340

H

341

R

342

O

343

U

344

G

345

H

346

347

S

348

O

349

C

350

K

351

S

352

5

353

354

E

355

N

356

D

357

P

358

O

359

I

360

N

361

T

362

"

363

,

364

365

"

366

C

367

O

368

D

369

E

370

"

371

:

372

373

"

374

C

375

U

376

R

377

L

378

379

-

380

X

381

382

S

383

O

384

C

385

K

386

S

387

5

388

:

389

/

390

/

391

U

392

S

393

E

394

R

395

:

396

P

397

A

398

S

399

S

400

@

401

P

402

R

403

O

404

X

405

Y

406

.

407

G

408

P

409

R

410

O

411

X

412

Y

413

.

414

N

415

E

416

T

417

:

418

1

419

0

420

0

421

1

422

423

H

424

T

425

T

426

P

427

S

428

:

429

/

430

/

431

H

432

T

433

T

434

P

435

B

436

I

437

N

438

.

439

O

440

R

441

G

442

/

443

I

444

P

445

"

446

}

447

,

448

449

{

450

"

451

T

452

I

453

T

454

L

455

E

456

"

457

:

458

459

"

460

S

461

E

462

T

463

464

G

465

E

466

O

467

-

468

T

469

A

470

R

471

G

472

E

473

T

474

I

475

N

476

G

477

"

478

,

479

480

"

481

D

482

E

483

S

484

C

485

R

486

I

487

P

488

T

489

I

490

O

491

N

492

"

493

:

494

495

"

496

T

497

A

498

R

499

G

500

E

501

T

502

503

A

504

505

S

506

P

507

E

508

C

509

I

510

F

511

I

512

C

513

514

C

515

O

516

U

517

N

518

T

519

R

520

Y

521

"

522

,

523

524

"

525

C

526

O

527

D

528

E

529

"

530

:

531

532

"

533

C

534

U

535

R

536

L

537

538

-

539

X

540

541

H

542

T

543

T

544

P

545

:

546

/

547

/

548

U

549

S

550

E

551

R

552

-

553

C

554

O

555

U

556

N

557

T

558

R

559

Y

560

-

561

D

562

E

563

:

564

P

565

A

566

S

567

S

568

@

569

P

570

R

571

O

572

X

573

Y

574

.

575

G

576

P

577

R

578

O

579

X

580

Y

581

.

582

N

583

E

584

T

585

:

586

1

587

0

588

0

589

0

590

591

H

592

T

593

T

594

P

595

S

596

:

597

/

598

/

599

H

600

T

601

T

602

P

603

B

604

I

605

N

606

.

607

O

608

R

609

G

610

/

611

I

612

P

613

"

614

}

615

,

616

617

{

618

"

619

T

620

I

621

T

622

L

623

E

624

"

625

:

626

627

"

628

U

629

S

630

E

631

632

E

633

N

634

V

635

I

636

R

637

O

638

N

639

M

640

E

641

N

642

T

643

644

V

645

A

646

R

647

I

648

A

649

B

650

L

651

E

652

S

653

"

654

,

655

656

"

657

D

658

E

659

S

660

C

661

R

662

I

663

P

664

T

665

I

666

O

667

N

668

"

669

:

670

671

"

672

S

673

E

674

T

675

676

P

677

R

678

O

679

X

680

Y

681

682

G

683

L

684

O

685

B

686

A

687

L

688

L

689

Y

690

691

F

692

O

693

R

694

695

A

696

L

697

L

698

699

R

700

E

701

Q

702

U

703

E

704

S

705

T

706

S

707

"

708

,

709

710

"

711

C

712

O

713

D

714

E

715

"

716

:

717

718

"

719

E

720

X

721

P

722

O

723

R

724

T

725

726

H

727

T

728

T

729

P

730

_

731

P

732

R

733

O

734

X

735

Y

736

=

737

H

738

T

739

T

740

P

741

:

742

/

743

/

744

U

745

S

746

E

747

R

748

:

749

P

750

A

751

S

752

S

753

@

754

P

755

R

756

O

757

X

758

Y

759

.

760

G

761

P

762

R

763

O

764

X

765

Y

766

.

767

N

768

E

769

T

770

:

771

1

772

0

773

0

774

0

775

\

776

N

777

E

778

X

779

P

780

O

781

R

782

T

783

784

H

785

T

786

T

787

P

788

S

789

_

790

P

791

R

792

O

793

X

794

Y

795

=

796

H

797

T

798

T

799

P

800

:

801

/

802

/

803

U

804

S

805

E

806

R

807

:

808

P

809

A

810

S

811

S

812

@

813

P

814

R

815

O

816

X

817

Y

818

.

819

G

820

P

821

R

822

O

823

X

824

Y

825

.

826

N

827

E

828

T

829

:

830

1

831

0

832

0

833

0

834

\

835

N

836

C

837

U

838

R

839

L

840

841

H

842

T

843

T

844

P

845

S

846

:

847

/

848

/

849

H

850

T

851

T

852

P

853

B

854

I

855

N

856

.

857

O

858

R

859

G

860

/

861

I

862

P

863

"

864

}

865

,

866

867

{

868

"

869

T

870

I

871

T

872

L

873

E

874

"

875

:

876

877

"

878

T

879

E

880

S

881

T

882

883

W

884

I

885

T

886

H

887

888

V

889

E

890

R

891

B

892

O

893

S

894

E

895

896

O

897

U

898

T

899

P

900

U

901

T

902

"

903

,

904

905

"

906

D

907

E

908

S

909

C

910

R

911

I

912

P

913

T

914

I

915

O

916

N

917

"

918

:

919

920

"

921

D

922

E

923

B

924

U

925

G

926

927

P

928

R

929

O

930

X

931

Y

932

933

C

934

O

935

N

936

N

937

E

938

C

939

T

940

I

941

O

942

N

943

944

W

945

I

946

T

947

H

948

949

-

950

V

951

952

F

953

L

954

A

955

G

956

"

957

,

958

959

"

960

C

961

O

962

D

963

E

964

"

965

:

966

967

"

968

C

969

U

970

R

971

L

972

973

-

974

V

975

976

-

977

X

978

979

H

980

T

981

T

982

P

983

:

984

/

985

/

986

U

987

S

988

E

989

R

990

:

991

P

992

A

993

S

994

S

995

@

996

P

997

R

998

O

999

X

1000

Y

1001

.

1002

G

1003

P

1004

R

1005

O

1006

X

1007

Y

1008

.

1009

N

1010

E

1011

T

1012

:

1013

1

1014

0

1015

0

1016

0

1017

1018

H

1019

T

1020

T

1021

P

1022

S

1023

:

1024

/

1025

/

1026

H

1027

T

1028

T

1029

P

1030

B

1031

I

1032

N

1033

.

1034

O

1035

R

1036

G

1037

/

1038

I

1039

P

1040

"

1041

}

1042

]

Code Examples

Why Use Proxies with cURL?

cURL is the universal command-line tool for HTTP requests, installed on virtually every Linux, macOS, and Windows system. Adding GProxy proxies to cURL lets you test proxy connections, debug API calls through different IPs, and build shell scripts for automated data collection. With GProxy's 10M+ residential IPs across 150+ countries, you can make requests from any location directly from your terminal.

Basic Proxy Syntax

cURL supports proxies through the -x or --proxy flag. The format is -x protocol://user:pass@host:port. GProxy supports HTTP, HTTPS, and SOCKS5 protocols, all configurable via this single flag.

Authentication Methods

GProxy supports two authentication methods with cURL: inline credentials in the proxy URL, and IP whitelist authentication (no credentials needed). For inline auth, include your username and password directly in the proxy URL. For IP whitelist, simply add your machine's IP to the GProxy dashboard and use the proxy without credentials.

SOCKS5 vs HTTP Proxy

cURL supports both HTTP and SOCKS5 proxies. Use HTTP proxies (-x http://...) for standard web requests. Use SOCKS5 (-x socks5://...) when you need to proxy non-HTTP traffic or when the target requires SOCKS5. GProxy provides both options on different ports.

Environment Variables

Set proxy for all cURL requests using environment variables: export HTTP_PROXY=http://user:pass@proxy.gproxy.net:1000 and HTTPS_PROXY. This is useful for shell scripts and CI/CD pipelines where you want all HTTP traffic to go through GProxy without modifying each command.

Geo-Targeting

Target specific countries by including the country code in your GProxy username: USER-country-us, USER-country-de, etc. This routes your request through a residential IP in that country, essential for testing geo-restricted APIs or verifying localized content.

Use Cases

[

{

"

T

I

T

L

E

"

:

"

A

P

I

T

E

S

T

I

N

G

"

,

"

D

E

S

C

R

I

P

T

I

O

N

"

:

"

T

E

S

T

A

P

I

S

F

R

O

M

D

I

F

E

R

E

N

T

L

O

C

A

T

I

O

N

S

A

N

D

I

P

S

T

O

V

E

R

I

F

Y

G

E

O

-

R

E

S

T

R

I

C

T

I

O

N

S

A

N

D

R

A

T

E

L

I

M

I

T

I

N

G

B

E

H

A

V

I

O

R

.

"

}

,

{

"

T

I

T

L

E

"

:

"

S

H

E

L

S

C

R

I

P

T

A

U

T

O

M

A

T

I

O

N

"

,

"

D

E

S

C

R

I

P

T

I

O

N

"

:

"

B

U

I

L

D

A

T

A

C

O

L

E

C

T

I

O

N

S

C

R

I

P

T

S

T

H

A

T

R

O

T

A

T

E

T

H

R

O

U

G

H

G

P

R

O

X

Y

I

P

S

A

U

T

O

M

A

T

I

C

A

L

Y

.

"

}

,

{

"

T

I

T

L

E

"

:

"

P

R

O

X

Y

C

O

N

E

C

T

I

O

N

T

E

S

T

I

N

G

"

,

"

D

E

S

C

R

I

P

T

I

O

N

"

:

"

Q

U

I

C

K

L

Y

V

E

R

I

F

Y

O

U

R

G

P

R

O

X

Y

C

R

E

D

E

N

T

I

A

L

S

A

N

D

P

R

O

X

Y

C

O

N

E

C

T

I

V

I

T

Y

F

R

O

M

T

H

E

C

O

M

A

N

D

L

I

N

E

.

"

}

,

{

"

T

I

T

L

E

"

:

"

C

I

/

C

D

P

I

P

E

L

I

N

E

I

N

T

E

G

R

A

T

I

O

N

"

,

"

D

E

S

C

R

I

P

T

I

O

N

"

:

"

R

O

U

T

E

C

I

/

C

D

H

T

P

R

E

Q

U

E

S

T

S

T

H

R

O

U

G

H

G

P

R

O

X

Y

U

S

I

N

G

E

N

V

I

R

O

N

M

E

N

T

V

A

R

I

A

B

L

E

S

F

O

R

C

O

N

S

I

S

T

E

N

T

E

S

T

I

N

G

.

"

}

]

Pro Tips

Use -w flag to measure response times through the proxy. Add --connect-timeout 10 to fail fast on proxy issues. Use .curlrc file for persistent proxy config. Pipe output to jq for JSON parsing in scripts.