How to Use Proxies with Node.js Axios: Complete Guide

TL;DR

Configure GProxy proxies with Axios in Node.js for HTTP requests. Covers proxy configuration, HTTPS support, rotation patterns, and error handling.

Get Proxies → Node.js Axios website →

Language: JavaScript

Prerequisites

✓[
✓"
✓N
✓o
✓d
✓e
✓.
✓j
✓s
✓
✓1
✓6
✓+
✓
✓i
✓n
✓s
✓t
✓a
✓l
✓l
✓e
✓d
✓"
✓,
✓
✓"
✓A
✓x
✓i
✓o
✓s
✓
✓i
✓n
✓s
✓t
✓a
✓l
✓l
✓e
✓d
✓
✓(
✓n
✓p
✓m
✓
✓i
✓n
✓s
✓t
✓a
✓l
✓l
✓
✓a
✓x
✓i
✓o
✓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
✓"
✓,
✓
✓"
✓B
✓a
✓s
✓i
✓c
✓
✓N
✓o
✓d
✓e
✓.
✓j
✓s
✓
✓a
✓n
✓d
✓
✓a
✓s
✓y
✓n
✓c
✓/
✓a
✓w
✓a
✓i
✓t
✓
✓k
✓n
✓o
✓w
✓l
✓e
✓d
✓g
✓e
✓"
✓]

Step-by-Step Setup

[

{

"

T

I

T

L

E

"

:

"

I

N

S

T

A

L

A

X

I

O

S

"

,

"

D

E

S

C

R

I

P

T

I

O

N

"

:

"

I

N

S

T

A

L

A

X

I

O

S

A

N

D

O

P

T

I

O

N

A

L

S

O

C

K

S

5 S

U

P

O

R

T

"

,

"

C

O

D

E

"

:

"

N

P

100

M

101

102

I

103

N

104

S

105

T

106

A

107

L

108

L

109

110

A

111

X

112

I

113

O

114

S

115

\

116

N

117

#

118

119

F

120

O

121

R

122

123

S

124

O

125

C

126

K

127

S

128

5

129

130

S

131

U

132

P

133

P

134

O

135

R

136

T

137

:

138

\

139

N

140

N

141

P

142

M

143

144

I

145

N

146

S

147

T

148

A

149

L

150

L

151

152

S

153

O

154

C

155

K

156

S

157

-

158

P

159

R

160

O

161

X

162

Y

163

-

164

A

165

G

166

E

167

N

168

T

169

"

170

}

171

,

172

173

{

174

"

175

T

176

I

177

T

178

L

179

E

180

"

181

:

182

183

"

184

C

185

O

186

N

187

F

188

I

189

G

190

U

191

R

192

E

193

194

H

195

T

196

T

197

P

198

199

P

200

R

201

O

202

X

203

Y

204

"

205

,

206

207

"

208

D

209

E

210

S

211

C

212

R

213

I

214

P

215

T

216

I

217

O

218

N

219

"

220

:

221

222

"

223

A

224

D

225

D

226

227

G

228

P

229

R

230

O

231

X

232

Y

233

234

P

235

R

236

O

237

X

238

Y

239

240

T

241

O

242

243

A

244

X

245

I

246

O

247

S

248

249

R

250

E

251

Q

252

U

253

E

254

S

255

T

256

257

C

258

O

259

N

260

F

261

I

262

G

263

"

264

,

265

266

"

267

C

268

O

269

D

270

E

271

"

272

:

273

274

"

275

C

276

O

277

N

278

S

279

T

280

281

A

282

X

283

I

284

O

285

S

286

287

=

288

289

R

290

E

291

Q

292

U

293

I

294

R

295

E

296

(

297

'

298

A

299

X

300

I

301

O

302

S

303

'

304

)

305

;

306

\

307

N

308

\

309

N

310

C

311

O

312

N

313

S

314

T

315

316

R

317

E

318

S

319

P

320

O

321

N

322

S

323

E

324

325

=

326

327

A

328

W

329

A

330

I

331

T

332

333

A

334

X

335

I

336

O

337

S

338

.

339

G

340

E

341

T

342

(

343

'

344

H

345

T

346

T

347

P

348

S

349

:

350

/

351

/

352

H

353

T

354

T

355

P

356

B

357

I

358

N

359

.

360

O

361

R

362

G

363

/

364

I

365

P

366

'

367

,

368

369

{

370

\

371

N

372

373

374

P

375

R

376

O

377

X

378

Y

379

:

380

381

{

382

\

383

N

384

385

386

387

388

H

389

O

390

S

391

T

392

:

393

394

'

395

P

396

R

397

O

398

X

399

Y

400

.

401

G

402

P

403

R

404

O

405

X

406

Y

407

.

408

N

409

E

410

T

411

'

412

,

413

\

414

N

415

416

417

418

419

P

420

O

421

R

422

T

423

:

424

425

1

426

0

427

0

428

0

429

,

430

\

431

N

432

433

434

435

436

A

437

U

438

T

439

H

440

:

441

442

{

443

444

U

445

S

446

E

447

R

448

N

449

A

450

M

451

E

452

:

453

454

'

455

Y

456

O

457

U

458

R

459

_

460

U

461

S

462

E

463

R

464

'

465

,

466

467

P

468

A

469

S

470

S

471

W

472

O

473

R

474

D

475

:

476

477

'

478

Y

479

O

480

U

481

R

482

_

483

P

484

A

485

S

486

S

487

'

488

489

}

490

\

491

N

492

493

494

}

495

\

496

N

497

}

498

)

499

;

500

\

501

N

502

C

503

O

504

N

505

S

506

O

507

L

508

E

509

.

510

L

511

O

512

G

513

(

514

R

515

E

516

S

517

P

518

O

519

N

520

S

521

E

522

.

523

D

524

A

525

T

526

A

527

)

528

;

529

"

530

}

531

,

532

533

{

534

"

535

T

536

I

537

T

538

L

539

E

540

"

541

:

542

543

"

544

S

545

E

546

T

547

548

U

549

P

550

551

S

552

O

553

C

554

K

555

S

556

5

557

558

P

559

R

560

O

561

X

562

Y

563

"

564

,

565

566

"

567

D

568

E

569

S

570

C

571

R

572

I

573

P

574

T

575

I

576

O

577

N

578

"

579

:

580

581

"

582

U

583

S

584

E

585

586

S

587

O

588

C

589

K

590

S

591

-

592

P

593

R

594

O

595

X

596

Y

597

-

598

A

599

G

600

E

601

N

602

T

603

604

F

605

O

606

R

607

608

S

609

O

610

C

611

K

612

S

613

5

614

615

S

616

U

617

P

618

P

619

O

620

R

621

T

622

"

623

,

624

625

"

626

C

627

O

628

D

629

E

630

"

631

:

632

633

"

634

C

635

O

636

N

637

S

638

T

639

640

{

641

642

S

643

O

644

C

645

K

646

S

647

P

648

R

649

O

650

X

651

Y

652

A

653

G

654

E

655

N

656

T

657

658

}

659

660

=

661

662

R

663

E

664

Q

665

U

666

I

667

R

668

E

669

(

670

'

671

S

672

O

673

C

674

K

675

S

676

-

677

P

678

R

679

O

680

X

681

Y

682

-

683

A

684

G

685

E

686

N

687

T

688

'

689

)

690

;

691

\

692

N

693

\

694

N

695

C

696

O

697

N

698

S

699

T

700

701

A

702

G

703

E

704

N

705

T

706

707

=

708

709

N

710

E

711

W

712

713

S

714

O

715

C

716

K

717

S

718

P

719

R

720

O

721

X

722

Y

723

A

724

G

725

E

726

N

727

T

728

(

729

'

730

S

731

O

732

C

733

K

734

S

735

5

736

:

737

/

738

/

739

U

740

S

741

E

742

R

743

:

744

P

745

A

746

S

747

S

748

@

749

P

750

R

751

O

752

X

753

Y

754

.

755

G

756

P

757

R

758

O

759

X

760

Y

761

.

762

N

763

E

764

T

765

:

766

1

767

0

768

0

769

1

770

'

771

)

772

;

773

\

774

N

775

C

776

O

777

N

778

S

779

T

780

781

R

782

E

783

S

784

P

785

O

786

N

787

S

788

E

789

790

=

791

792

A

793

W

794

A

795

I

796

T

797

798

A

799

X

800

I

801

O

802

S

803

.

804

G

805

E

806

T

807

(

808

'

809

H

810

T

811

T

812

P

813

S

814

:

815

/

816

/

817

H

818

T

819

T

820

P

821

B

822

I

823

N

824

.

825

O

826

R

827

G

828

/

829

I

830

P

831

'

832

,

833

834

{

835

\

836

N

837

838

839

H

840

T

841

T

842

P

843

S

844

A

845

G

846

E

847

N

848

T

849

:

850

851

A

852

G

853

E

854

N

855

T

856

,

857

858

H

859

T

860

T

861

P

862

A

863

G

864

E

865

N

866

T

867

:

868

869

A

870

G

871

E

872

N

873

T

874

\

875

N

876

}

877

)

878

;

879

"

880

}

881

,

882

883

{

884

"

885

T

886

I

887

T

888

L

889

E

890

"

891

:

892

893

"

894

C

895

R

896

E

897

A

898

T

899

E

900

901

R

902

E

903

U

904

S

905

A

906

B

907

L

908

E

909

910

C

911

L

912

I

913

E

914

N

915

T

916

"

917

,

918

919

"

920

D

921

E

922

S

923

C

924

R

925

I

926

P

927

T

928

I

929

O

930

N

931

"

932

:

933

934

"

935

B

936

U

937

I

938

L

939

D

940

941

A

942

N

943

944

A

945

X

946

I

947

O

948

S

949

950

I

951

N

952

S

953

T

954

A

955

N

956

C

957

E

958

959

W

960

I

961

T

962

H

963

964

P

965

R

966

O

967

X

968

Y

969

970

D

971

E

972

F

973

A

974

U

975

L

976

T

977

S

978

"

979

,

980

981

"

982

C

983

O

984

D

985

E

986

"

987

:

988

989

"

990

C

991

O

992

N

993

S

994

T

995

996

C

997

L

998

I

999

E

1000

N

1001

T

1002

1003

=

1004

1005

A

1006

X

1007

I

1008

O

1009

S

1010

.

1011

C

1012

R

1013

E

1014

A

1015

T

1016

E

1017

(

1018

{

1019

\

1020

N

1021

1022

1023

P

1024

R

1025

O

1026

X

1027

Y

1028

:

1029

1030

{

1031

\

1032

N

1033

1034

1035

1036

1037

H

1038

O

1039

S

1040

T

1041

:

1042

1043

'

1044

P

1045

R

1046

O

1047

X

1048

Y

1049

.

1050

G

1051

P

1052

R

1053

O

1054

X

1055

Y

1056

.

1057

N

1058

E

1059

T

1060

'

1061

,

1062

\

1063

N

1064

1065

1066

1067

1068

P

1069

O

1070

R

1071

T

1072

:

1073

1074

1

1075

0

1076

0

1077

0

1078

,

1079

\

1080

N

1081

1082

1083

1084

1085

A

1086

U

1087

T

1088

H

1089

:

1090

1091

{

1092

1093

U

1094

S

1095

E

1096

R

1097

N

1098

A

1099

M

1100

E

1101

:

1102

1103

'

1104

Y

1105

O

1106

U

1107

R

1108

_

1109

U

1110

S

1111

E

1112

R

1113

'

1114

,

1115

1116

P

1117

A

1118

S

1119

S

1120

W

1121

O

1122

R

1123

D

1124

:

1125

1126

'

1127

Y

1128

O

1129

U

1130

R

1131

_

1132

P

1133

A

1134

S

1135

S

1136

'

1137

1138

}

1139

\

1140

N

1141

1142

1143

}

1144

,

1145

\

1146

N

1147

1148

1149

T

1150

I

1151

M

1152

E

1153

O

1154

U

1155

T

1156

:

1157

1158

3

1159

0

1160

0

1161

0

1162

0

1163

\

1164

N

1165

}

1166

)

1167

;

1168

\

1169

N

1170

\

1171

N

1172

C

1173

O

1174

N

1175

S

1176

T

1177

1178

D

1179

A

1180

T

1181

A

1182

1183

=

1184

1185

A

1186

W

1187

A

1188

I

1189

T

1190

1191

C

1192

L

1193

I

1194

E

1195

N

1196

T

1197

.

1198

G

1199

E

1200

T

1201

(

1202

'

1203

H

1204

T

1205

T

1206

P

1207

S

1208

:

1209

/

1210

/

1211

E

1212

X

1213

A

1214

M

1215

P

1216

L

1217

E

1218

.

1219

C

1220

O

1221

M

1222

'

1223

)

1224

;

1225

"

1226

}

1227

,

1228

1229

{

1230

"

1231

T

1232

I

1233

T

1234

L

1235

E

1236

"

1237

:

1238

1239

"

1240

A

1241

D

1242

D

1243

1244

R

1245

E

1246

T

1247

R

1248

Y

1249

1250

I

1251

N

1252

T

1253

E

1254

R

1255

C

1256

E

1257

P

1258

T

1259

O

1260

R

1261

"

1262

,

1263

1264

"

1265

D

1266

E

1267

S

1268

C

1269

R

1270

I

1271

P

1272

T

1273

I

1274

O

1275

N

1276

"

1277

:

1278

1279

"

1280

H

1281

A

1282

N

1283

D

1284

L

1285

E

1286

1287

P

1288

R

1289

O

1290

X

1291

Y

1292

1293

E

1294

R

1295

R

1296

O

1297

R

1298

S

1299

1300

W

1301

I

1302

T

1303

H

1304

1305

A

1306

U

1307

T

1308

O

1309

M

1310

A

1311

T

1312

I

1313

C

1314

1315

R

1316

E

1317

T

1318

R

1319

Y

1320

"

1321

,

1322

1323

"

1324

C

1325

O

1326

D

1327

E

1328

"

1329

:

1330

1331

"

1332

C

1333

L

1334

I

1335

E

1336

N

1337

T

1338

.

1339

I

1340

N

1341

T

1342

E

1343

R

1344

C

1345

E

1346

P

1347

T

1348

O

1349

R

1350

S

1351

.

1352

R

1353

E

1354

S

1355

P

1356

O

1357

N

1358

S

1359

E

1360

.

1361

U

1362

S

1363

E

1364

(

1365

\

1366

N

1367

1368

1369

R

1370

E

1371

S

1372

P

1373

O

1374

N

1375

S

1376

E

1377

1378

=

1379

>

1380

1381

R

1382

E

1383

S

1384

P

1385

O

1386

N

1387

S

1388

E

1389

,

1390

\

1391

N

1392

1393

1394

A

1395

S

1396

Y

1397

N

1398

C

1399

1400

E

1401

R

1402

R

1403

O

1404

R

1405

1406

=

1407

>

1408

1409

{

1410

\

1411

N

1412

1413

1414

1415

1416

I

1417

F

1418

1419

(

1420

E

1421

R

1422

R

1423

O

1424

R

1425

.

1426

R

1427

E

1428

S

1429

P

1430

O

1431

N

1432

S

1433

E

1434

?

1435

.

1436

S

1437

T

1438

A

1439

T

1440

U

1441

S

1442

1443

=

1444

=

1445

=

1446

1447

4

1448

0

1449

7

1450

1451

|

1452

|

1453

1454

E

1455

R

1456

R

1457

O

1458

R

1459

.

1460

C

1461

O

1462

D

1463

E

1464

1465

=

1466

=

1467

=

1468

1469

'

1470

E

1471

C

1472

O

1473

N

1474

N

1475

R

1476

E

1477

S

1478

E

1479

T

1480

'

1481

)

1482

1483

{

1484

\

1485

N

1486

1487

1488

1489

1490

1491

1492

R

1493

E

1494

T

1495

U

1496

R

1497

N

1498

1499

C

1500

L

1501

I

1502

E

1503

N

1504

T

1505

.

1506

R

1507

E

1508

Q

1509

U

1510

E

1511

S

1512

T

1513

(

1514

E

1515

R

1516

R

1517

O

1518

R

1519

.

1520

C

1521

O

1522

N

1523

F

1524

I

1525

G

1526

)

1527

;

1528

1529

/

1530

/

1531

1532

R

1533

E

1534

T

1535

R

1536

Y

1537

\

1538

N

1539

1540

1541

1542

1543

}

1544

\

1545

N

1546

1547

1548

1549

1550

T

1551

H

1552

R

1553

O

1554

W

1555

1556

E

1557

R

1558

R

1559

O

1560

R

1561

;

1562

\

1563

N

1564

1565

1566

}

1567

\

1568

N

1569

)

1570

;

1571

"

1572

}

1573

,

1574

1575

{

1576

"

1577

T

1578

I

1579

T

1580

L

1581

E

1582

"

1583

:

1584

1585

"

1586

T

1587

E

1588

S

1589

T

1590

1591

T

1592

H

1593

E

1594

1595

S

1596

E

1597

T

1598

U

1599

P

1600

"

1601

,

1602

1603

"

1604

D

1605

E

1606

S

1607

C

1608

R

1609

I

1610

P

1611

T

1612

I

1613

O

1614

N

1615

"

1616

:

1617

1618

"

1619

V

1620

E

1621

R

1622

I

1623

F

1624

Y

1625

1626

P

1627

R

1628

O

1629

X

1630

Y

1631

1632

I

1633

S

1634

1635

R

1636

O

1637

U

1638

T

1639

I

1640

N

1641

G

1642

1643

C

1644

O

1645

R

1646

R

1647

E

1648

C

1649

T

1650

L

1651

Y

1652

"

1653

,

1654

1655

"

1656

C

1657

O

1658

D

1659

E

1660

"

1661

:

1662

1663

"

1664

C

1665

O

1666

N

1667

S

1668

T

1669

1670

R

1671

E

1672

S

1673

1674

=

1675

1676

A

1677

W

1678

A

1679

I

1680

T

1681

1682

C

1683

L

1684

I

1685

E

1686

N

1687

T

1688

.

1689

G

1690

E

1691

T

1692

(

1693

'

1694

H

1695

T

1696

T

1697

P

1698

S

1699

:

1700

/

1701

/

1702

H

1703

T

1704

T

1705

P

1706

B

1707

I

1708

N

1709

.

1710

O

1711

R

1712

G

1713

/

1714

I

1715

P

1716

'

1717

)

1718

;

1719

\

1720

N

1721

C

1722

O

1723

N

1724

S

1725

O

1726

L

1727

E

1728

.

1729

L

1730

O

1731

G

1732

(

1733

'

1734

P

1735

R

1736

O

1737

X

1738

Y

1739

1740

I

1741

P

1742

:

1743

'

1744

,

1745

1746

R

1747

E

1748

S

1749

.

1750

D

1751

A

1752

T

1753

A

1754

.

1755

O

1756

R

1757

I

1758

G

1759

I

1760

N

1761

)

1762

;

1763

"

1764

}

1765

]

Code Examples

Why Use Proxies with Axios?

Axios is the most popular HTTP client for Node.js and browsers, with over 100 million weekly npm downloads. Adding GProxy proxies to Axios enables IP rotation for web scraping, API access from different locations, and anonymous request handling. GProxy's 10M+ residential IPs and 150+ country coverage integrate seamlessly with Axios's proxy configuration.

Basic Proxy Configuration

Axios supports HTTP proxies through its built-in proxy config option. Pass the proxy host, port, and authentication credentials directly in the request config or as a default. For HTTPS targets through an HTTP proxy, Axios handles the CONNECT tunnel automatically.

SOCKS5 Proxy Support

Axios doesn't support SOCKS5 natively, but you can add it with the socks-proxy-agent package. Create a SOCKS5 agent and pass it as the httpsAgent in your Axios config. This works with GProxy's SOCKS5 endpoints.

Request Interceptors for Proxy Logic

Axios interceptors let you add proxy rotation logic, retry on failures, and logging. Add a request interceptor to dynamically assign proxies, and a response interceptor to handle proxy errors and retry with a different IP.

Concurrent Requests

Node.js's async nature makes it perfect for concurrent proxied requests. Use Promise.all() or p-limit to control concurrency. Each request through GProxy's backconnect endpoint gets a unique IP, so concurrent requests naturally rotate.

Error Handling Best Practices

Proxy-specific errors need special handling: 407 means authentication failure, ECONNREFUSED means the proxy is unreachable, and ETIMEDOUT means the proxy or target is slow. Set appropriate timeouts and implement retry logic with exponential backoff for production reliability.

Use Cases

[

{

"

T

I

T

L

E

"

:

"

A

P

I

D

A

T

A

C

O

L

E

C

T

I

O

N

"

,

"

D

E

S

C

R

I

P

T

I

O

N

"

:

"

C

O

L

E

C

T

D

A

T

A

F

R

O

M

A

P

I

S

T

H

A

T

E

N

F

O

R

C

E

P

E

R

-

I

P

R

A

T

E

L

I

M

I

T

S

U

S

I

N

G

R

O

T

A

T

I

N

G

P

R

O

X

I

E

S

.

"

}

,

{

"

T

I

T

L

E

"

:

"

P

R

I

C

E

M

O

N

I

T

O

R

I

N

G

S

E

R

V

I

C

E

S

"

,

"

D

E

S

C

R

I

P

T

I

O

N

"

:

"

B

U

I

L

D

P

R

I

C

E

T

R

A

C

K

I

N

G

M

I

C

R

O

S

E

R

V

I

C

E

S

T

H

A

T

Q

U

E

R

Y

R

E

T

A

I

L

E

R

S

F

R

O

M

D

I

F

E

R

E

N

T

L

O

C

A

T

I

O

N

S

.

"

}

,

{

"

T

I

T

L

E

"

:

"

W

E

B

H

O

K

T

E

S

T

I

N

G

"

,

"

D

E

S

C

R

I

P

T

I

O

N

"

:

"

S

E

N

D

T

E

S

T

W

E

B

H

O

K

S

F

R

O

M

D

I

F

E

R

E

N

T

I

P

S

T

O

V

E

R

I

F

Y

O

U

R

A

P

L

I

C

A

T

I

O

N

'

S

E

C

U

R

I

T

Y

F

I

L

T

E

R

S

.

"

}

,

{

"

T

I

T

L

E

"

:

"

M

I

C

R

O

S

E

R

V

I

C

E

T

E

S

T

I

N

G

"

,

"

D

E

S

C

R

I

P

T

I

O

N

"

:

"

T

E

S

T

Y

O

U

R

O

W

N

A

P

I

S

F

R

O

M

E

X

T

E

R

N

A

L

I

P

S

T

O

V

E

R

I

F

Y

R

A

T

E

L

I

M

I

T

I

N

G

A

N

D

G

E

O

-

B

L

O

C

K

I

N

G

R

U

L

E

S

.

"

}

]

Pro Tips

Create a dedicated Axios instance with proxy defaults for clean code. Use p-limit to control concurrency and avoid overwhelming target servers. Add response interceptors for automatic retry on proxy errors. Set reasonable timeouts (30s) to handle slow proxy connections gracefully.