Como usar proxies com Puppeteer: guia completo

TL;DR

Configure proxies GProxy com Puppeteer para automação do Chrome headless. Cobre autenticação de proxy, troca de proxy por página e técnicas de stealth.

Obter proxies → Puppeteer site →

Idioma: JavaScript

Pré-requisitos

✓[
✓"
✓N
✓o
✓d
✓e
✓.
✓j
✓s
✓
✓1
✓6
✓+
✓
✓i
✓n
✓s
✓t
✓a
✓l
✓a
✓d
✓o
✓"
✓,
✓
✓"
✓P
✓u
✓p
✓p
✓e
✓t
✓e
✓e
✓r
✓
✓i
✓n
✓s
✓t
✓a
✓l
✓a
✓d
✓o
✓
✓(
✓n
✓p
✓m
✓
✓i
✓n
✓s
✓t
✓a
✓l
✓l
✓
✓p
✓u
✓p
✓p
✓e
✓t
✓e
✓e
✓r
✓)
✓"
✓,
✓
✓"
✓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
✓"
✓,
✓
✓"
✓C
✓o
✓n
✓h
✓e
✓c
✓i
✓m
✓e
✓n
✓t
✓o
✓
✓b
✓á
✓s
✓i
✓c
✓o
✓
✓d
✓e
✓
✓J
✓a
✓v
✓a
✓S
✓c
✓r
✓i
✓p
✓t
✓/
✓a
✓s
✓y
✓n
✓c
✓-
✓a
✓w
✓a
✓i
✓t
✓"
✓]

Configuração passo a passo

[

{

"

T

I

T

L

E

"

:

"

I

N

S

T

A

L

A

R

O

P

U

P

E

T

E

R

"

,

"

D

E

S

C

R

I

P

T

I

O

N

"

:

"

I

N

S

T

A

L

E

O

P

U

P

E

T

E

R

C

O

M

N

P

M

"

,

"

C

O

D

E

"

:

"

N

P

M

I

N

S

T

A

100

L

101

L

102

103

P

104

U

105

P

106

P

107

E

108

T

109

E

110

E

111

R

112

113

P

114

U

115

P

116

P

117

E

118

T

119

E

120

E

121

R

122

-

123

E

124

X

125

T

126

R

127

A

128

129

P

130

U

131

P

132

P

133

E

134

T

135

E

136

E

137

R

138

-

139

E

140

X

141

T

142

R

143

A

144

-

145

P

146

L

147

U

148

G

149

I

150

N

151

-

152

S

153

T

154

E

155

A

156

L

157

T

158

H

159

"

160

}

161

,

162

163

{

164

"

165

T

166

I

167

T

168

L

169

E

170

"

171

:

172

173

"

174

I

175

N

176

I

177

C

178

I

179

A

180

R

181

182

O

183

184

N

185

A

186

V

187

E

188

G

189

A

190

D

191

O

192

R

193

194

C

195

O

196

M

197

198

P

199

R

200

O

201

X

202

Y

203

"

204

,

205

206

"

207

D

208

E

209

S

210

C

211

R

212

I

213

P

214

T

215

I

216

O

217

N

218

"

219

:

220

221

"

222

C

223

O

224

N

225

F

226

I

227

G

228

U

229

R

230

E

231

232

O

233

234

C

235

H

236

R

237

O

238

M

239

E

240

241

C

242

O

243

M

244

245

O

246

247

P

248

R

249

O

250

X

251

Y

252

253

D

254

A

255

256

G

257

P

258

R

259

O

260

X

261

Y

262

"

263

,

264

265

"

266

C

267

O

268

D

269

E

270

"

271

:

272

273

"

274

C

275

O

276

N

277

S

278

T

279

280

P

281

U

282

P

283

P

284

E

285

T

286

E

287

E

288

R

289

290

=

291

292

R

293

E

294

Q

295

U

296

I

297

R

298

E

299

(

300

'

301

P

302

U

303

P

304

P

305

E

306

T

307

E

308

E

309

R

310

'

311

)

312

;

313

\

314

N

315

\

316

N

317

C

318

O

319

N

320

S

321

T

322

323

B

324

R

325

O

326

W

327

S

328

E

329

R

330

331

=

332

333

A

334

W

335

A

336

I

337

T

338

339

P

340

U

341

P

342

P

343

E

344

T

345

E

346

E

347

R

348

.

349

L

350

A

351

U

352

N

353

C

354

H

355

(

356

{

357

\

358

N

359

360

361

A

362

R

363

G

364

S

365

:

366

367

[

368

'

369

-

370

-

371

P

372

R

373

O

374

X

375

Y

376

-

377

S

378

E

379

R

380

V

381

E

382

R

383

=

384

H

385

T

386

T

387

P

388

:

389

/

390

/

391

P

392

R

393

O

394

X

395

Y

396

.

397

G

398

P

399

R

400

O

401

X

402

Y

403

.

404

N

405

E

406

T

407

:

408

1

409

0

410

0

411

0

412

'

413

]

414

\

415

N

416

}

417

)

418

;

419

\

420

N

421

C

422

O

423

N

424

S

425

T

426

427

P

428

A

429

G

430

E

431

432

=

433

434

A

435

W

436

A

437

I

438

T

439

440

B

441

R

442

O

443

W

444

S

445

E

446

R

447

.

448

N

449

E

450

W

451

P

452

A

453

G

454

E

455

(

456

)

457

;

458

"

459

}

460

,

461

462

{

463

"

464

T

465

I

466

T

467

L

468

E

469

"

470

:

471

472

"

473

A

474

U

475

T

476

E

477

N

478

T

479

I

480

C

481

A

482

R

483

484

N

485

O

486

487

P

488

R

489

O

490

X

491

Y

492

"

493

,

494

495

"

496

D

497

E

498

S

499

C

500

R

501

I

502

P

503

T

504

I

505

O

506

N

507

"

508

:

509

510

"

511

D

512

E

513

F

514

I

515

N

516

A

517

518

A

519

S

520

521

C

522

R

523

E

524

D

525

E

526

N

527

C

528

I

529

A

530

I

531

S

532

533

D

534

O

535

536

P

537

R

538

O

539

X

540

Y

541

542

U

543

S

544

A

545

N

546

D

547

O

548

549

P

550

A

551

G

552

E

553

.

554

A

555

U

556

T

557

H

558

E

559

N

560

T

561

I

562

C

563

A

564

T

565

E

566

(

567

)

568

"

569

,

570

571

"

572

C

573

O

574

D

575

E

576

"

577

:

578

579

"

580

A

581

W

582

A

583

I

584

T

585

586

P

587

A

588

G

589

E

590

.

591

A

592

U

593

T

594

H

595

E

596

N

597

T

598

I

599

C

600

A

601

T

602

E

603

(

604

{

605

\

606

N

607

608

609

U

610

S

611

E

612

R

613

N

614

A

615

M

616

E

617

:

618

619

'

620

Y

621

O

622

U

623

R

624

_

625

U

626

S

627

E

628

R

629

N

630

A

631

M

632

E

633

'

634

,

635

\

636

N

637

638

639

P

640

A

641

S

642

S

643

W

644

O

645

R

646

D

647

:

648

649

'

650

Y

651

O

652

U

653

R

654

_

655

P

656

A

657

S

658

S

659

W

660

O

661

R

662

D

663

'

664

\

665

N

666

}

667

)

668

;

669

\

670

N

671

\

672

N

673

A

674

W

675

A

676

I

677

T

678

679

P

680

A

681

G

682

E

683

.

684

G

685

O

686

T

687

O

688

(

689

'

690

H

691

T

692

T

693

P

694

S

695

:

696

/

697

/

698

H

699

T

700

T

701

P

702

B

703

I

704

N

705

.

706

O

707

R

708

G

709

/

710

I

711

P

712

'

713

)

714

;

715

\

716

N

717

C

718

O

719

N

720

S

721

O

722

L

723

E

724

.

725

L

726

O

727

G

728

(

729

A

730

W

731

A

732

I

733

T

734

735

P

736

A

737

G

738

E

739

.

740

C

741

O

742

N

743

T

744

E

745

N

746

T

747

(

748

)

749

)

750

;

751

"

752

}

753

,

754

755

{

756

"

757

T

758

I

759

T

760

L

761

E

762

"

763

:

764

765

"

766

A

767

D

768

I

769

C

770

I

771

O

772

N

773

A

774

R

775

776

O

777

778

P

779

L

780

U

781

G

782

I

783

N

784

785

S

786

T

787

E

788

A

789

L

790

T

791

H

792

"

793

,

794

795

"

796

D

797

E

798

S

799

C

800

R

801

I

802

P

803

T

804

I

805

O

806

N

807

"

808

:

809

810

"

811

U

812

S

813

E

814

815

O

816

817

P

818

U

819

P

820

P

821

E

822

T

823

E

824

E

825

R

826

-

827

E

828

X

829

T

830

R

831

A

832

-

833

P

834

L

835

U

836

G

837

I

838

N

839

-

840

S

841

T

842

E

843

A

844

L

845

T

846

H

847

848

P

849

A

850

R

851

A

852

853

E

854

V

855

I

856

T

857

A

858

R

859

860

D

861

E

862

T

863

E

864

C

865

Ç

866

Ã

867

O

868

"

869

,

870

871

"

872

C

873

O

874

D

875

E

876

"

877

:

878

879

"

880

C

881

O

882

N

883

S

884

T

885

886

P

887

U

888

P

889

P

890

E

891

T

892

E

893

E

894

R

895

896

=

897

898

R

899

E

900

Q

901

U

902

I

903

R

904

E

905

(

906

'

907

P

908

U

909

P

910

P

911

E

912

T

913

E

914

E

915

R

916

-

917

E

918

X

919

T

920

R

921

A

922

'

923

)

924

;

925

\

926

N

927

C

928

O

929

N

930

S

931

T

932

933

S

934

T

935

E

936

A

937

L

938

T

939

H

940

P

941

L

942

U

943

G

944

I

945

N

946

947

=

948

949

R

950

E

951

Q

952

U

953

I

954

R

955

E

956

(

957

'

958

P

959

U

960

P

961

P

962

E

963

T

964

E

965

E

966

R

967

-

968

E

969

X

970

T

971

R

972

A

973

-

974

P

975

L

976

U

977

G

978

I

979

N

980

-

981

S

982

T

983

E

984

A

985

L

986

T

987

H

988

'

989

)

990

;

991

\

992

N

993

P

994

U

995

P

996

P

997

E

998

T

999

E

1000

E

1001

R

1002

.

1003

U

1004

S

1005

E

1006

(

1007

S

1008

T

1009

E

1010

A

1011

L

1012

T

1013

H

1014

P

1015

L

1016

U

1017

G

1018

I

1019

N

1020

(

1021

)

1022

)

1023

;

1024

\

1025

N

1026

\

1027

N

1028

C

1029

O

1030

N

1031

S

1032

T

1033

1034

B

1035

R

1036

O

1037

W

1038

S

1039

E

1040

R

1041

1042

=

1043

1044

A

1045

W

1046

A

1047

I

1048

T

1049

1050

P

1051

U

1052

P

1053

P

1054

E

1055

T

1056

E

1057

E

1058

R

1059

.

1060

L

1061

A

1062

U

1063

N

1064

C

1065

H

1066

(

1067

{

1068

\

1069

N

1070

1071

1072

A

1073

R

1074

G

1075

S

1076

:

1077

1078

[

1079

'

1080

-

1081

-

1082

P

1083

R

1084

O

1085

X

1086

Y

1087

-

1088

S

1089

E

1090

R

1091

V

1092

E

1093

R

1094

=

1095

H

1096

T

1097

T

1098

P

1099

:

1100

/

1101

/

1102

P

1103

R

1104

O

1105

X

1106

Y

1107

.

1108

G

1109

P

1110

R

1111

O

1112

X

1113

Y

1114

.

1115

N

1116

E

1117

T

1118

:

1119

1

1120

0

1121

0

1122

0

1123

'

1124

]

1125

\

1126

N

1127

}

1128

)

1129

;

1130

"

1131

}

1132

,

1133

1134

{

1135

"

1136

T

1137

I

1138

T

1139

L

1140

E

1141

"

1142

:

1143

1144

"

1145

B

1146

L

1147

O

1148

Q

1149

U

1150

E

1151

A

1152

R

1153

1154

R

1155

E

1156

C

1157

U

1158

R

1159

S

1160

O

1161

S

1162

1163

D

1164

E

1165

S

1166

N

1167

E

1168

C

1169

E

1170

S

1171

S

1172

Á

1173

R

1174

I

1175

O

1176

S

1177

"

1178

,

1179

1180

"

1181

D

1182

E

1183

S

1184

C

1185

R

1186

I

1187

P

1188

T

1189

I

1190

O

1191

N

1192

"

1193

:

1194

1195

"

1196

A

1197

C

1198

E

1199

L

1200

E

1201

R

1202

E

1203

1204

O

1205

1206

S

1207

C

1208

R

1209

A

1210

P

1211

I

1212

N

1213

G

1214

1215

B

1216

L

1217

O

1218

Q

1219

U

1220

E

1221

A

1222

N

1223

D

1224

O

1225

1226

I

1227

M

1228

A

1229

G

1230

E

1231

N

1232

S

1233

1234

E

1235

1236

F

1237

O

1238

N

1239

T

1240

E

1241

S

1242

"

1243

,

1244

1245

"

1246

C

1247

O

1248

D

1249

E

1250

"

1251

:

1252

1253

"

1254

A

1255

W

1256

A

1257

I

1258

T

1259

1260

P

1261

A

1262

G

1263

E

1264

.

1265

S

1266

E

1267

T

1268

R

1269

E

1270

Q

1271

U

1272

E

1273

S

1274

T

1275

I

1276

N

1277

T

1278

E

1279

R

1280

C

1281

E

1282

P

1283

T

1284

I

1285

O

1286

N

1287

(

1288

T

1289

R

1290

U

1291

E

1292

)

1293

;

1294

\

1295

N

1296

P

1297

A

1298

G

1299

E

1300

.

1301

O

1302

N

1303

(

1304

'

1305

R

1306

E

1307

Q

1308

U

1309

E

1310

S

1311

T

1312

'

1313

,

1314

1315

(

1316

R

1317

E

1318

Q

1319

)

1320

1321

=

1322

>

1323

1324

{

1325

\

1326

N

1327

1328

1329

I

1330

F

1331

1332

(

1333

[

1334

'

1335

I

1336

M

1337

A

1338

G

1339

E

1340

'

1341

,

1342

1343

'

1344

F

1345

O

1346

N

1347

T

1348

'

1349

,

1350

1351

'

1352

S

1353

T

1354

Y

1355

L

1356

E

1357

S

1358

H

1359

E

1360

E

1361

T

1362

'

1363

]

1364

.

1365

I

1366

N

1367

C

1368

L

1369

U

1370

D

1371

E

1372

S

1373

(

1374

R

1375

E

1376

Q

1377

.

1378

R

1379

E

1380

S

1381

O

1382

U

1383

R

1384

C

1385

E

1386

T

1387

Y

1388

P

1389

E

1390

(

1391

)

1392

)

1393

)

1394

\

1395

N

1396

1397

1398

1399

1400

R

1401

E

1402

Q

1403

.

1404

A

1405

B

1406

O

1407

R

1408

T

1409

(

1410

)

1411

;

1412

\

1413

N

1414

1415

1416

E

1417

L

1418

S

1419

E

1420

\

1421

N

1422

1423

1424

1425

1426

R

1427

E

1428

Q

1429

.

1430

C

1431

O

1432

N

1433

T

1434

I

1435

N

1436

U

1437

E

1438

(

1439

)

1440

;

1441

\

1442

N

1443

}

1444

)

1445

;

1446

"

1447

}

1448

,

1449

1450

{

1451

"

1452

T

1453

I

1454

T

1455

L

1456

E

1457

"

1458

:

1459

1460

"

1461

T

1462

E

1463

S

1464

T

1465

A

1466

R

1467

1468

E

1469

1470

V

1471

E

1472

R

1473

I

1474

F

1475

I

1476

C

1477

A

1478

R

1479

"

1480

,

1481

1482

"

1483

D

1484

E

1485

S

1486

C

1487

R

1488

I

1489

P

1490

T

1491

I

1492

O

1493

N

1494

"

1495

:

1496

1497

"

1498

C

1499

O

1500

N

1501

F

1502

I

1503

R

1504

M

1505

E

1506

1507

Q

1508

U

1509

E

1510

1511

O

1512

1513

P

1514

R

1515

O

1516

X

1517

Y

1518

1519

E

1520

S

1521

T

1522

Á

1523

1524

F

1525

U

1526

N

1527

C

1528

I

1529

O

1530

N

1531

A

1532

N

1533

D

1534

O

1535

1536

C

1537

O

1538

R

1539

R

1540

E

1541

T

1542

A

1543

M

1544

E

1545

N

1546

T

1547

E

1548

"

1549

,

1550

1551

"

1552

C

1553

O

1554

D

1555

E

1556

"

1557

:

1558

1559

"

1560

A

1561

W

1562

A

1563

I

1564

T

1565

1566

P

1567

A

1568

G

1569

E

1570

.

1571

G

1572

O

1573

T

1574

O

1575

(

1576

'

1577

H

1578

T

1579

T

1580

P

1581

S

1582

:

1583

/

1584

/

1585

H

1586

T

1587

T

1588

P

1589

B

1590

I

1591

N

1592

.

1593

O

1594

R

1595

G

1596

/

1597

I

1598

P

1599

'

1600

)

1601

;

1602

\

1603

N

1604

C

1605

O

1606

N

1607

S

1608

T

1609

1610

B

1611

O

1612

D

1613

Y

1614

1615

=

1616

1617

A

1618

W

1619

A

1620

I

1621

T

1622

1623

P

1624

A

1625

G

1626

E

1627

.

1628

E

1629

V

1630

A

1631

L

1632

U

1633

A

1634

T

1635

E

1636

(

1637

(

1638

)

1639

1640

=

1641

>

1642

1643

D

1644

O

1645

C

1646

U

1647

M

1648

E

1649

N

1650

T

1651

.

1652

B

1653

O

1654

D

1655

Y

1656

.

1657

I

1658

N

1659

N

1660

E

1661

R

1662

T

1663

E

1664

X

1665

T

1666

)

1667

;

1668

\

1669

N

1670

C

1671

O

1672

N

1673

S

1674

O

1675

L

1676

E

1677

.

1678

L

1679

O

1680

G

1681

(

1682

'

1683

C

1684

U

1685

R

1686

R

1687

E

1688

N

1689

T

1690

1691

I

1692

P

1693

:

1694

'

1695

,

1696

1697

J

1698

S

1699

O

1700

N

1701

.

1702

P

1703

A

1704

R

1705

S

1706

E

1707

(

1708

B

1709

O

1710

D

1711

Y

1712

)

1713

.

1714

O

1715

R

1716

I

1717

G

1718

I

1719

N

1720

)

1721

;

1722

\

1723

N

1724

A

1725

W

1726

A

1727

I

1728

T

1729

1730

B

1731

R

1732

O

1733

W

1734

S

1735

E

1736

R

1737

.

1738

C

1739

L

1740

O

1741

S

1742

E

1743

(

1744

)

1745

;

1746

"

1747

}

1748

]

Exemplos de código

Por que usar proxies com Puppeteer?

Puppeteer é a biblioteca oficial do Google em Node.js para controlar o Chrome headless. Ela é amplamente usada para web scraping, testes e automação. Ao acessar sites em escala, você precisa de proxies para evitar bloqueios de IP e limites de requisições. O pool da GProxy, com 10M+ IPs residenciais em 150+ países, faz seus scripts de Puppeteer parecerem usuários reais de qualquer localidade.

Configuração básica de proxy

O Puppeteer suporta configuração de proxy pelos argumentos de inicialização do Chrome. Passe --proxy-server ao iniciar o navegador. Para os proxies HTTP da GProxy, o formato é direto. Diferente do Selenium, o Puppeteer dá controle programático sobre a autenticação de proxy pelo método page.authenticate(), eliminando a necessidade de extensões de navegador.

Autenticação de proxy por página

O método page.authenticate() do Puppeteer resolve a autenticação de proxy de forma elegante. Chame-o antes de navegar para definir as credenciais que serão enviadas automaticamente quando o proxy solicitar autenticação. Isso funciona com a autenticação por usuário/senha da GProxy sem nenhum ajuste.

Estratégias de rotação de proxy

Com o Puppeteer você tem duas estratégias de rotação: no nível do navegador (iniciar um novo navegador por proxy) e no nível de contexto (criar novos contextos anônimos). Os contextos de navegador são mais leves que instâncias completas do navegador e suportam configurações de proxy diferentes por contexto, o que os torna ideais para scraping concorrente com IPs diferentes.

Stealth e antidetecção

Sites modernos usam fingerprinting para detectar navegadores automatizados. Combine os proxies residenciais da GProxy com o puppeteer-extra e o plugin stealth para escapar da detecção. O plugin stealth corrige vetores de detecção comuns como navigator.webdriver, chrome.runtime e fingerprints de WebGL.

Otimização de desempenho

Otimize o Puppeteer com proxies assim: bloqueie recursos desnecessários (imagens, fontes, CSS) usando interceptação de requisições, defina timeouts adequados, reutilize instâncias do navegador com páginas novas e use os proxies de datacenter da GProxy para tarefas de scraping sensíveis à velocidade e não sensíveis a bloqueio.

Casos de uso

[

{

"

T

I

T

L

E

"

:

"

S

C

R

A

P

I

N

G

D

E

S

P

A

"

,

"

D

E

S

C

R

I

P

T

I

O

N

"

:

"

E

X

T

R

A

I

A

D

A

D

O

S

D

E

A

P

L

I

C

A

Ç

Õ

E

S

I

N

G

L

E

-

P

A

G

E

Q

U

E

X

I

G

E

M

E

X

E

C

U

Ç

Ã

O

D

E

J

A

V

A

S

C

R

I

P

T

P

A

R

A

R

E

N

D

E

R

I

Z

A

R

O

C

O

N

T

E

Ú

D

O

.

"

}

,

{

"

T

I

T

L

E

"

:

"

S

E

R

V

I

Ç

O

S

D

E

S

C

R

E

N

S

H

O

T

"

,

"

D

E

S

C

R

I

P

T

I

O

N

"

:

"

G

E

R

E

C

A

P

T

U

R

A

S

D

E

T

E

L

A

D

E

S

I

T

E

S

A

P

A

R

T

I

R

D

E

D

I

F

E

R

E

N

T

E

S

P

A

Í

S

E

S

U

S

A

N

D

O

P

R

O

X

I

E

S

C

O

M

G

E

O

L

O

C

A

L

I

Z

A

Ç

Ã

O

.

"

}

,

{

"

T

I

T

L

E

"

:

"

C

O

M

P

A

R

A

Ç

Ã

O

D

E

P

R

E

Ç

O

S

"

,

"

D

E

S

C

R

I

P

T

I

O

N

"

:

"

M

O

N

I

T

O

R

E

P

R

E

Ç

O

S

D

E

C

O

N

C

O

R

E

N

T

E

S

E

M

V

Á

R

I

A

S

R

E

G

I

Õ

E

S

C

O

M

I

P

S

R

E

S

I

D

E

N

C

I

A

I

S

E

S

P

E

C

Í

F

I

C

O

S

P

O

R

L

O

C

A

L

I

D

A

D

E

.

"

}

,

{

"

T

I

T

L

E

"

:

"

A

U

T

O

M

A

Ç

Ã

O

D

E

R

E

D

E

S

O

C

I

A

I

S

"

,

"

D

E

S

C

R

I

P

T

I

O

N

"

:

"

A

U

T

O

M

A

T

I

Z

E

F

L

U

X

O

S

D

E

R

E

D

E

S

O

C

I

A

I

S

C

O

M

I

P

S

Ú

N

I

C

O

S

P

O

R

C

O

N

T

A

.

"

}

]

Dicas Pro

Use contextos de navegador em vez de novas instâncias do navegador para rotacionar proxies mais rápido. Bloqueie imagens e fontes via interceptação de requisições para economizar banda. Defina o viewport em 1920x1080 para evitar detecção de mobile. Combine o plugin stealth com IPs residenciais da GProxy para máxima evasão.